# Cloud Monitoring API . metricDescriptors

## Instance Methods

Create a new metric.

Delete an existing metric.

List metric descriptors that match the query. If the query is not set, then all of the metric descriptors will be returned. Large responses will be paginated, use the nextPageToken returned in the response to request subsequent pages of results by setting the pageToken query parameter to the value of the nextPageToken.

Retrieves the next page of results.

### Method Details

`create(project, body)`

    Create a new metric.

    Args:
      project: string, The project id. The value can be the numeric project ID or string-based project name. (required)
      body: object, The request body. (required)
        The object takes the form of:

    { # A metricDescriptor defines the name, label keys, and data type of a particular metric.
        "project": "A String", # The project ID to which the metric belongs.
        "labels": [ # Labels defined for this metric.
          { # A label in a metric is a description of this metric, including the key of this description (what the description is), and the value for this description.
            "description": "A String", # Label description.
            "key": "A String", # Label key.
          },
        ],
        "typeDescriptor": { # A type in a metric contains information about how the metric is collected and what its data points look like. # Type description for this metric.
          "valueType": "A String", # The data type of of individual points in the metric's time series. See Metric value types.
          "metricType": "A String", # The method of collecting data for the metric. See Metric types.
        },
        "description": "A String", # Description of this metric.
        "name": "A String", # The name of this metric.
      }

    Returns:
      An object of the form:

        { # A metricDescriptor defines the name, label keys, and data type of a particular metric.
          "project": "A String", # The project ID to which the metric belongs.
          "labels": [ # Labels defined for this metric.
            { # A label in a metric is a description of this metric, including the key of this description (what the description is), and the value for this description.
              "description": "A String", # Label description.
              "key": "A String", # Label key.
            },
          ],
          "typeDescriptor": { # A type in a metric contains information about how the metric is collected and what its data points look like. # Type description for this metric.
            "valueType": "A String", # The data type of of individual points in the metric's time series. See Metric value types.
            "metricType": "A String", # The method of collecting data for the metric. See Metric types.
          },
          "description": "A String", # Description of this metric.
          "name": "A String", # The name of this metric.
        }

`delete(project, metric)`

    Delete an existing metric.

    Args:
      project: string, The project ID to which the metric belongs. (required)
      metric: string, Name of the metric. (required)

    Returns:
      An object of the form:

        { # The response of cloudmonitoring.metricDescriptors.delete.
        "kind": "cloudmonitoring#deleteMetricDescriptorResponse", # Identifies what kind of resource this is. Value: the fixed string "cloudmonitoring#deleteMetricDescriptorResponse".
      }

`list(project, count=None, pageToken=None, query=None)`

    List metric descriptors that match the query. If the query is not set, then all of the metric descriptors will be returned. Large responses will be paginated, use the nextPageToken returned in the response to request subsequent pages of results by setting the pageToken query parameter to the value of the nextPageToken.

    Args:
      project: string, The project id. The value can be the numeric project ID or string-based project name. (required)
      count: integer, Maximum number of metric descriptors per page. Used for pagination. If not specified, count = 100.
      pageToken: string, The pagination token, which is used to page through large result sets. Set this value to the value of the nextPageToken to retrieve the next page of results.
      query: string, The query used to search against existing metrics. Separate keywords with a space; the service joins all keywords with AND, meaning that all keywords must match for a metric to be returned. If this field is omitted, all metrics are returned. If an empty string is passed with this field, no metrics are returned.

    Returns:
      An object of the form:

        { # The response of cloudmonitoring.metricDescriptors.list.
        "metrics": [ # The returned metric descriptors.
          { # A metricDescriptor defines the name, label keys, and data type of a particular metric.
              "project": "A String", # The project ID to which the metric belongs.
              "labels": [ # Labels defined for this metric.
                { # A label in a metric is a description of this metric, including the key of this description (what the description is), and the value for this description.
                  "description": "A String", # Label description.
                  "key": "A String", # Label key.
                },
              ],
              "typeDescriptor": { # A type in a metric contains information about how the metric is collected and what its data points look like. # Type description for this metric.
                "valueType": "A String", # The data type of of individual points in the metric's time series. See Metric value types.
                "metricType": "A String", # The method of collecting data for the metric. See Metric types.
              },
              "description": "A String", # Description of this metric.
              "name": "A String", # The name of this metric.
            },
        ],
        "nextPageToken": "A String", # Pagination token. If present, indicates that additional results are available for retrieval. To access the results past the pagination limit, pass this value to the pageToken query parameter.
        "kind": "cloudmonitoring#listMetricDescriptorsResponse", # Identifies what kind of resource this is. Value: the fixed string "cloudmonitoring#listMetricDescriptorsResponse".
      }

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