# Cloud Monitoring API . projects . notificationChannelDescriptors

## Instance Methods

Gets a single channel descriptor. The descriptor indicates which fields are expected / permitted for a notification channel of the given type.

Lists the descriptors for supported channel types. The use of descriptors makes it possible for new channel types to be dynamically added.

Retrieves the next page of results.

### Method Details

`get(name, x__xgafv=None)`

    Gets a single channel descriptor. The descriptor indicates which fields are expected / permitted for a notification channel of the given type.

    Args:
      name: string, Required. The channel type for which to execute the request. The format is:
    projects/[PROJECT_ID_OR_NUMBER]/notificationChannelDescriptors/[CHANNEL_TYPE]
     (required)
      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # A description of a notification channel. The descriptor includes the properties of the channel and the set of labels or fields that must be specified to configure channels of a given type.
        "name": "A String", # The full REST resource name for this descriptor. The format is:
            # projects/[PROJECT_ID_OR_NUMBER]/notificationChannelDescriptors/[TYPE]
            # In the above, [TYPE] is the value of the type field.
        "labels": [ # The set of labels that must be defined to identify a particular channel of the corresponding type. Each label includes a description for how that field should be populated.
          { # A description of a label.
            "key": "A String", # The key for this label. The key must meet the following criteria:
                # Does not exceed 100 characters.
                # Matches the following regular expression: [a-zA-Z][a-zA-Z0-9_]*
                # The first character must be an upper- or lower-case letter.
                # The remaining characters must be letters, digits, or underscores.
            "description": "A String", # A human-readable description for the label.
            "valueType": "A String", # The type of data that can be assigned to the label.
          },
        ],
        "type": "A String", # The type of notification channel, such as "email" and "sms". To view the full list of channels, see Channel descriptors (https://cloud.google.com/monitoring/alerts/using-channels-api#ncd). Notification channel types are globally unique.
        "displayName": "A String", # A human-readable name for the notification channel type. This form of the name is suitable for a user interface.
        "description": "A String", # A human-readable description of the notification channel type. The description may include a description of the properties of the channel and pointers to external documentation.
        "launchStage": "A String", # The product launch stage for channels of this type.
      }

`list(name, pageToken=None, pageSize=None, x__xgafv=None)`

    Lists the descriptors for supported channel types. The use of descriptors makes it possible for new channel types to be dynamically added.

    Args:
      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 this names the parent container in which to look for the descriptors; to retrieve a single descriptor by name, use the GetNotificationChannelDescriptor operation, instead. (required)
      pageToken: string, If non-empty, page_token must contain a value returned as the next_page_token in a previous response to request the next set of results.
      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.
      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # The ListNotificationChannelDescriptors response.
        "channelDescriptors": [ # The monitored resource descriptors supported for the specified project, optionally filtered.
          { # A description of a notification channel. The descriptor includes the properties of the channel and the set of labels or fields that must be specified to configure channels of a given type.
            "name": "A String", # The full REST resource name for this descriptor. The format is:
                # projects/[PROJECT_ID_OR_NUMBER]/notificationChannelDescriptors/[TYPE]
                # In the above, [TYPE] is the value of the type field.
            "labels": [ # The set of labels that must be defined to identify a particular channel of the corresponding type. Each label includes a description for how that field should be populated.
              { # A description of a label.
                "key": "A String", # The key for this label. The key must meet the following criteria:
                    # Does not exceed 100 characters.
                    # Matches the following regular expression: [a-zA-Z][a-zA-Z0-9_]*
                    # The first character must be an upper- or lower-case letter.
                    # The remaining characters must be letters, digits, or underscores.
                "description": "A String", # A human-readable description for the label.
                "valueType": "A String", # The type of data that can be assigned to the label.
              },
            ],
            "type": "A String", # The type of notification channel, such as "email" and "sms". To view the full list of channels, see Channel descriptors (https://cloud.google.com/monitoring/alerts/using-channels-api#ncd). Notification channel types are globally unique.
            "displayName": "A String", # A human-readable name for the notification channel type. This form of the name is suitable for a user interface.
            "description": "A String", # A human-readable description of the notification channel type. The description may include a description of the properties of the channel and pointers to external documentation.
            "launchStage": "A String", # The product launch stage for channels of this type.
          },
        ],
        "nextPageToken": "A String", # If not empty, indicates that there may be more results that match the request. Use the value in the page_token field in a subsequent request to fetch the next set of results. If empty, all results have been returned.
      }

`list_next(previous_request, previous_response)`

    Retrieves the next page of results.

    Args:
      previous_request: The request for the previous page. (required)
      previous_response: The response from the request for the previous page. (required)

    Returns:
      A request object that you can call 'execute()' on to request the next
      page. Returns None if there are no more items in the collection.