Cloud Monitoring API

Manages your Cloud Monitoring data and configurations.

Service: monitoring.googleapis.com

To call this service, we recommend that you use the Google-providedclient libraries. If your application needs to use your own libraries to call this service, use the following information when you make the API requests.

Discovery document

ADiscovery Document is a machine-readable specification for describing and consuming REST APIs. It is used to build client libraries, IDE plugins, and other tools that interact with Google APIs. One service may provide multiple discovery documents. This service provides the following discovery documents:

Service endpoint

Aservice endpoint is a base URL that specifies the network address of an API service. One service might have multiple service endpoints. This service has the following service endpoint and all URIs below are relative to this service endpoint:

  • https://monitoring.googleapis.com

REST Resource:v3.folders.timeSeries

Methods
listGET /v3/{name}/timeSeries
Lists time series that match a filter.

REST Resource:v3.organizations.timeSeries

Methods
listGET /v3/{name}/timeSeries
Lists time series that match a filter.

REST Resource:v3.projects.alertPolicies

Methods
createPOST /v3/{name}/alertPolicies
Creates a new alerting policy.
deleteDELETE /v3/{name}
Deletes an alerting policy.
getGET /v3/{name}
Gets a single alerting policy.
listGET /v3/{name}/alertPolicies
Lists the existing alerting policies for the workspace.
patchPATCH /v3/{alertPolicy.name}
Updates an alerting policy.

REST Resource:v3.projects.alerts

Methods
getGET /v3/{name}
Gets a single alert.
listGET /v3/{parent}/alerts
Lists the existing alerts for the metrics scope of the project.

REST Resource:v3.projects.groups

Methods
createPOST /v3/{name}/groups
Creates a new group.
deleteDELETE /v3/{name}
Deletes an existing group.
getGET /v3/{name}
Gets a single group.
listGET /v3/{name}/groups
Lists the existing groups.
updatePUT /v3/{group.name}
Updates an existing group.

REST Resource:v3.projects.groups.members

Methods
listGET /v3/{name}/members
Lists the monitored resources that are members of a group.

REST Resource:v3.projects.metricDescriptors

Methods
createPOST /v3/{name}/metricDescriptors
Creates a new metric descriptor.
deleteDELETE /v3/{name}
Deletes a metric descriptor.
getGET /v3/{name}
Gets a single metric descriptor.
listGET /v3/{name}/metricDescriptors
Lists metric descriptors that match a filter.

REST Resource:v3.projects.monitoredResourceDescriptors

Methods
getGET /v3/{name}
Gets a single monitored resource descriptor.
listGET /v3/{name}/monitoredResourceDescriptors
Lists monitored resource descriptors that match a filter.

REST Resource:v3.projects.notificationChannelDescriptors

Methods
getGET /v3/{name}
Gets a single channel descriptor.
listGET /v3/{name}/notificationChannelDescriptors
Lists the descriptors for supported channel types.

REST Resource:v3.projects.notificationChannels

Methods
createPOST /v3/{name}/notificationChannels
Creates a new notification channel, representing a single notification endpoint such as an email address, SMS number, or PagerDuty service.
deleteDELETE /v3/{name}
Deletes a notification channel.
getGET /v3/{name}
Gets a single notification channel.
getVerificationCodePOST /v3/{name}:getVerificationCode
Requests a verification code for an already verified channel that can then be used in a call to VerifyNotificationChannel() on a different channel with an equivalent identity in the same or in a different project.
listGET /v3/{name}/notificationChannels
Lists the notification channels that have been created for the project.
patchPATCH /v3/{notificationChannel.name}
Updates a notification channel.
sendVerificationCodePOST /v3/{name}:sendVerificationCode
Causes a verification code to be delivered to the channel.
verifyPOST /v3/{name}:verify
Verifies aNotificationChannel by proving receipt of the code delivered to the channel as a result of callingSendNotificationChannelVerificationCode.

REST Resource:v3.projects.snoozes

Methods
createPOST /v3/{parent}/snoozes
Creates aSnooze that will prevent alerts, which match the provided criteria, from being opened.
getGET /v3/{name}
Retrieves aSnooze byname.
listGET /v3/{parent}/snoozes
Lists theSnoozes associated with a project.
patchPATCH /v3/{snooze.name}
Updates aSnooze, identified by itsname, with the parameters in the givenSnooze object.

REST Resource:v3.projects.timeSeries

Methods
createPOST /v3/{name}/timeSeries
Creates or adds data to one or more time series.
listGET /v3/{name}/timeSeries
Lists time series that match a filter.
query
(deprecated)
POST /v3/{name}/timeSeries:query
Queries time series by using Monitoring Query Language (MQL).

REST Resource:v3.projects.uptimeCheckConfigs

Methods
createPOST /v3/{parent}/uptimeCheckConfigs
Creates a new Uptime check configuration.
deleteDELETE /v3/{name}
Deletes an Uptime check configuration.
getGET /v3/{name}
Gets a single Uptime check configuration.
listGET /v3/{parent}/uptimeCheckConfigs
Lists the existing valid Uptime check configurations for the project (leaving out any invalid configurations).
patchPATCH /v3/{uptimeCheckConfig.name}
Updates an Uptime check configuration.

REST Resource:v3.services

Methods
createPOST /v3/{parent}/services
Create aService.
deleteDELETE /v3/{name}
Soft delete thisService.
getGET /v3/{name}
Get the namedService.
listGET /v3/{parent}/services
ListServices for this Metrics Scope.
patchPATCH /v3/{service.name}
Update thisService.

REST Resource:v3.services.serviceLevelObjectives

Methods
createPOST /v3/{parent}/serviceLevelObjectives
Create aServiceLevelObjective for the givenService.
deleteDELETE /v3/{name}
Delete the givenServiceLevelObjective.
getGET /v3/{name}
Get aServiceLevelObjective by name.
listGET /v3/{parent}/serviceLevelObjectives
List theServiceLevelObjectives for the givenService.
patchPATCH /v3/{serviceLevelObjective.name}
Update the givenServiceLevelObjective.

REST Resource:v3.uptimeCheckIps

Methods
listGET /v3/uptimeCheckIps
Returns the list of IP addresses that checkers run from.

REST Resource:v1.locations.global.metricsScopes

Methods
getGET /v1/{name}
Returns a specificMetrics Scope, including the list of projects monitored by the specifiedMetrics Scope.
listMetricsScopesByMonitoredProjectGET /v1/locations/global/metricsScopes:listMetricsScopesByMonitoredProject
Returns a list of everyMetrics Scope that a specificMonitoredProject has been added to.

REST Resource:v1.locations.global.metricsScopes.projects

Methods
createPOST /v1/{parent}/projects
Adds aMonitoredProject with the given project ID to the specifiedMetrics Scope.
deleteDELETE /v1/{name}
Deletes aMonitoredProject from the specifiedMetrics Scope.

REST Resource:v1.operations

Methods
getGET /v1/{name}
Gets the latest state of a long-running operation.

REST Resource:v1.projects.dashboards

Methods
createPOST /v1/{parent}/dashboards
Creates a new custom dashboard.
deleteDELETE /v1/{name}
Deletes an existing custom dashboard.
getGET /v1/{name}
Fetches a specific dashboard.
listGET /v1/{parent}/dashboards
Lists the existing dashboards.
patchPATCH /v1/{dashboard.name}
Replaces an existing custom dashboard with a new definition.

REST Resource:v1.projects.location.prometheus.api.v1

Methods
labelsGET /v1/{name}/location/{location}/prometheus/api/v1/labels
Lists labels for metrics.
queryGET /v1/{name}/location/{location}/prometheus/api/v1/query
Evaluate a PromQL query at a single point in time.
query_exemplarsGET /v1/{name}/location/{location}/prometheus/api/v1/query_exemplars
Lists exemplars relevant to a given PromQL query,
query_rangeGET /v1/{name}/location/{location}/prometheus/api/v1/query_range
Evaluate a PromQL query with [start, end] time range.
seriesGET /v1/{name}/location/{location}/prometheus/api/v1/series
Lists metadata for metrics.

REST Resource:v1.projects.location.prometheus.api.v1.label

Methods
valuesGET /v1/{name}/location/{location}/prometheus/api/v1/label/{label}/values
Lists possible values for a given label name.

REST Resource:v1.projects.location.prometheus.api.v1.metadata

Methods
listGET /v1/{name}/location/{location}/prometheus/api/v1/metadata
Lists metadata for metrics.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-10-23 UTC.