Lists monitored resource descriptors that match a filter.
HTTP request
GET https://monitoring.googleapis.com/v3/{name}/monitoredResourceDescriptors
Path parameters
Parameters
name
string
Required. The project on which to execute the request. The format is:
projects/[PROJECT_ID_OR_NUMBER]
Query parameters
Parameters
filter
string
An optional filter describing the descriptors to be returned. The filter can reference the descriptor's type and labels. For example, the following filter returns only Google Compute Engine descriptors that have an id label:
resource.type = starts_with("gce_") AND resource.label:id
pageSize
integer
A positive number that is the maximum number of results to return.
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 additional results from the previous method call.
Request body
The request body must be empty.
Response body
The monitoredResourceDescriptors.list response.
If successful, the response body contains data with the following structure:
The monitored resource descriptors that are available to this project and that match filter, if present.
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 as pageToken in the next call to this method.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-07-23 UTC."],[],[],null,["# Method: projects.monitoredResourceDescriptors.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListMonitoredResourceDescriptorsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists monitored resource descriptors that match a filter.\n\n### HTTP request\n\n`GET https://monitoring.googleapis.com/v3/{name}/monitoredResourceDescriptors`\n\n### Path parameters\n\n### Query parameters\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nThe `monitoredResourceDescriptors.list` response.\n\nIf successful, the response body contains data with the following structure:\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n- `\n https://www.googleapis.com/auth/monitoring`\n- `\n https://www.googleapis.com/auth/monitoring.read`\n- `\n https://www.googleapis.com/auth/monitoring.write`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp)."]]