# Stackdriver 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, The channel type for which to execute the request. The format is projects/[PROJECT_ID]/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.
        "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.
        "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.
            "valueType": "A String", # The type of data that can be assigned to the label.
            "description": "A String", # A human-readable description for the label.
            "key": "A String", # The label key.
          },
        ],
        "supportedTiers": [ # The tiers that support this notification channel; the project service tier must be one of the supported_tiers.
          "A String",
        ],
        "type": "A String", # The type of notification channel, such as "email", "sms", etc. Notification channel types are globally unique.
        "name": "A String", # The full REST resource name for this descriptor. The syntax is:
            # projects/[PROJECT_ID]/notificationChannelDescriptors/[TYPE]
            # In the above, [TYPE] is the value of the type field.
      }

`list(name, pageToken=None, x__xgafv=None, pageSize=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, The REST resource name of the parent from which to retrieve the notification channel descriptors. The expected syntax is:
    projects/[PROJECT_ID]
    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.
      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format
      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.

    Returns:
      An object of the form:

        { # The ListNotificationChannelDescriptors response.
        "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.
        "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.
            "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.
            "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.
                "valueType": "A String", # The type of data that can be assigned to the label.
                "description": "A String", # A human-readable description for the label.
                "key": "A String", # The label key.
              },
            ],
            "supportedTiers": [ # The tiers that support this notification channel; the project service tier must be one of the supported_tiers.
              "A String",
            ],
            "type": "A String", # The type of notification channel, such as "email", "sms", etc. Notification channel types are globally unique.
            "name": "A String", # The full REST resource name for this descriptor. The syntax is:
                # projects/[PROJECT_ID]/notificationChannelDescriptors/[TYPE]
                # In the above, [TYPE] is the value of the type field.
          },
        ],
      }

`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.