Method: projects.uptimeCheckConfigs.list

Lists the existing valid uptime check configurations for the project, leaving out any invalid configurations.

HTTP request

GET https://monitoring.googleapis.com/v3/{parent}/uptimeCheckConfigs

Path parameters

Parameters
parent

string

The project whose uptime check configurations are listed. The format is projects/[PROJECT_ID].

Authorization requires the following Google IAM permission on the specified resource parent:

  • monitoring.uptimeCheckConfigs.list

Query parameters

Parameters
pageSize

number

The maximum number of results to return in a single response. The server may further constrain the maximum number of results returned in a single page. If the pageSize is <=0, the server will decide the number of results to be returned.

pageToken

string

If this field is not empty then it must contain the nextPageToken value returned by a previous call to this method. Using this field causes the method to return more results from the previous method call.

Request body

The request body must be empty.

Response body

If successful, the response body contains data with the following structure:

The protocol for the uptimeCheckConfigs.list response.

JSON representation
{
  "uptimeCheckConfigs": [
    {
      object(UptimeCheckConfig)
    }
  ],
  "nextPageToken": string,
  "totalSize": number
}
Fields
uptimeCheckConfigs[]

object(UptimeCheckConfig)

The returned uptime check configurations.

nextPageToken

string

This field represents the pagination token to retrieve the next page of results. If the value is empty, it means no further results for the request. To retrieve the next page of results, the value of the nextPageToken is passed to the subsequent List method call (in the request message's pageToken field).

totalSize

number

The total number of uptime check configurations for the project, irrespective of any pagination.

Authorization Scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/monitoring
  • https://www.googleapis.com/auth/monitoring.read

For more information, see the Authentication Overview.

Try it!

Was this page helpful? Let us know how we did:

Send feedback about...

Stackdriver Monitoring