Method: monitoredResourceDescriptors.list

Lists the descriptors for monitored resource types used by Logging.

HTTP request

GET https://logging.googleapis.com/v2/monitoredResourceDescriptors

The URL usesgRPC Transcoding syntax.

Query parameters

Parameters
pageSize

integer

Optional. The maximum number of results to return from this request. Non-positive values are ignored. The presence ofnextPageToken in the response indicates that more results might be available.

pageToken

string

Optional. If present, then retrieve the next batch of results from the preceding call to this method.pageToken must be the value ofnextPageToken from the previous response. The values of other method parameters should be identical to those in the previous call.

Request body

The request body must be empty.

Response body

Result returned from monitoredResourceDescriptors.list.

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

JSON representation
{"resourceDescriptors":[{object (MonitoredResourceDescriptor)}],"nextPageToken":string}
Fields
resourceDescriptors[]

object (MonitoredResourceDescriptor)

A list of resource descriptors.

nextPageToken

string

If there might be more results than those appearing in this response, thennextPageToken is included. To get the next set of results, call this method again using the value ofnextPageToken aspageToken.

Authorization scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/logging.read
  • https://www.googleapis.com/auth/logging.admin
  • https://www.googleapis.com/auth/cloud-platform.read-only
  • https://www.googleapis.com/auth/cloud-platform

For more information, see theAuthentication Overview.

MonitoredResourceDescriptor

An object that describes the schema of aMonitoredResource object using a type name and a set of labels. For example, the monitored resource descriptor for Google Compute Engine VM instances has a type of"gce_instance" and specifies the use of the labels"instance_id" and"zone" to identify particular VM instances.

Different APIs can support different monitored resource types. APIs generally provide alist method that returns the monitored resource descriptors used by the API.

JSON representation
{"name":string,"type":string,"displayName":string,"description":string,"labels":[{object (LabelDescriptor)}],"launchStage":enum (LaunchStage)}
Fields
name

string

Optional. The resource name of the monitored resource descriptor:"projects/{projectId}/monitoredResourceDescriptors/{type}" where {type} is the value of thetype field in this object and {projectId} is a project ID that provides API-specific context for accessing the type. APIs that do not use project information can use the resource name format"monitoredResourceDescriptors/{type}".

type

string

Required. The monitored resource type. For example, the type"cloudsql_database" represents databases in Google Cloud SQL. For a list of types, seeMonitored resource types andLogging resource types.

displayName

string

Optional. A concise name for the monitored resource type that might be displayed in user interfaces. It should be a Title Cased Noun Phrase, without any article or other determiners. For example,"Google Cloud SQL Database".

description

string

Optional. A detailed description of the monitored resource type that might be used in documentation.

labels[]

object (LabelDescriptor)

Required. A set of labels used to describe instances of this monitored resource type. For example, an individual Google Cloud SQL database is identified by values for the labels"database_id" and"zone".

launchStage

enum (LaunchStage)

Optional. The launch stage of the monitored resource definition.

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-21 UTC.