Lists the descriptors for supported channel types. The use of descriptors makes it possible for new channel types to be dynamically added.
HTTP request
GET https://monitoring.googleapis.com/v3/{name}/notificationChannelDescriptors
Path parameters
Parameters
name
string
Required. The REST resource name of the parent from which to retrieve the notification channel descriptors. The expected syntax is:
projects/[PROJECT_ID_OR_NUMBER]
Note that thisnamesthe parent container in which to look for the descriptors; to retrieve a single descriptor by name, use thenotificationChannelDescriptors.getoperation, instead.
Authorization requires the followingIAMpermission on the specified resourcename:
monitoring.notificationChannelDescriptors.list
Query parameters
Parameters
pageSize
integer
The maximum number of results to return in a single response. If not set to a positive number, a reasonable value will be chosen by the service.
pageToken
string
If non-empty,pageTokenmust contain a value returned as thenextPageTokenin a previous response to request the next set of results.
Request body
The request body must be empty.
Response body
ThenotificationChannelDescriptors.listresponse.
If successful, the response body contains data with the following structure:
The monitored resource descriptors supported for the specified project, optionally filtered.
nextPageToken
string
If not empty, indicates that there may be more results that match the request. Use the value in thepageTokenfield in a subsequent request to fetch the next set of results. If empty, all results have been returned.
[[["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.notificationChannelDescriptors.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.ListNotificationChannelDescriptorsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists the descriptors for supported channel types. The use of descriptors makes it possible for new channel types to be dynamically added.\n\n### HTTP request\n\n`GET https://monitoring.googleapis.com/v3/{name}/notificationChannelDescriptors`\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 `notificationChannelDescriptors.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\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp)."]]
