Method: services.serviceLevelObjectives.list

List theServiceLevelObjectives for the givenService.

HTTP request

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

Path parameters

Parameters
parent

string

Required. Resource name of the parent containing the listed SLOs, either a project or a Monitoring Metrics Scope. The formats are:

projects/[PROJECT_ID_OR_NUMBER]/services/[SERVICE_ID]workspaces/[HOST_PROJECT_ID_OR_NUMBER]/services/-

Query parameters

Parameters
filter

string

A filter specifying whatServiceLevelObjectives to return.

pageSize

integer

A non-negative number that is the maximum number of results to return. When 0, use default page size.

pageToken

string

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

view

enum (View)

View of theServiceLevelObjectives to return. IfDEFAULT, return eachServiceLevelObjective as originally defined. IfEXPLICIT and theServiceLevelObjective is defined in terms of aBasicSli, replace theBasicSli with aRequestBasedSli spelling out how the SLI is computed.

Request body

The request body must be empty.

Response body

TheserviceLevelObjectives.list response.

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

JSON representation
{"serviceLevelObjectives":[{object (ServiceLevelObjective)}],"nextPageToken":string}
Fields
serviceLevelObjectives[]

object (ServiceLevelObjective)

TheServiceLevelObjectives matching the specified filter.

nextPageToken

string

If there are more results than have been returned, then this field is set to a non-empty value. To see the additional results, use that value aspageToken in the next call to this method.

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 theAuthentication Overview.

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-07-23 UTC.