Yandex Cloud
  • Services
  • Solutions
  • Why Yandex Cloud
  • Blog
  • Pricing
  • Documentation
  • Contact us
Get started
Language / Region
Yandex project
© 2023 Yandex.Cloud LLC
Yandex Monitoring
  • Getting started
  • Step-by-step instructions
    • All instructions
    • Working with metrics
      • Delivering Linux system metrics
      • Delivering custom application metrics
      • Delivering metrics from HAProxy and other third-party applications
      • Delivering metrics from hosts outside Yandex Cloud
      • Writing custom metrics via the API
      • Getting a list of metrics
      • Downloading metrics
      • Exporting metrics in Prometheus format
    • Working with dashboards
      • Creating dashboards
      • Copying dashboards
      • Adding widgets to a dashboard
      • Deleting widgets from a dashboard
      • Deleting dashboards
      • Examples of working with the gRPC API
    • Working with alerts
      • Creating alerts
      • Creating notification channels
      • Deleting alerts
  • Concepts
    • Service overview
    • Data model
    • Visualization
      • Overview
      • Query string
      • Widgets
      • Dashboards
    • Transmitting metrics
      • Agent for delivering metrics
        • Overview
        • Installation and startup
        • Configuration
        • Best practices for using the agent
    • Query language
    • Alerting
    • Data decimation
    • Deleting expired metrics (TTL)
    • Quotas and limits
  • Access management
  • Pricing policy
    • Current pricing policy
    • Archive
      • Policy before October 1, 2020
  • API reference
    • Authentication in the API
    • REST
      • Overview
      • MetricsData
        • Overview
        • read
        • write
        • prometheusMetrics
      • MetricsMeta
        • Overview
        • listLabelKeys
        • listLabelValues
        • listMetricNames
        • listMetrics
    • gRPC
      • Overview
      • DashboardService
  • Metric reference
  • Questions and answers
    • General questions
    • Navigation
    • Metric collection and export
    • Metrics and units of measure
    • Alerts / notifications
    • All questions on one page
  1. API reference
  2. REST
  3. MetricsMeta
  4. listLabelValues

Method listLabelValues

Written by
Yandex Cloud
  • HTTP request
  • Path parameters
  • Query parameters
  • Response

Returns a list of values for the specified label key.

HTTP request

GET https://monitoring.api.cloud.yandex.net/monitoring/v2/metrics/labels/{labelKey}/values

Path parameters

Parameter Description
labelKey Required field. Label key that a search is performed by.

Query parameters

Parameter Description
folderId Required field. ID of the folder that the metric belongs to. Maximum string length: 50 characters.
selectors Metric selectors to search by label.
valueFilter Substring text used for filtering by label value.
pageSize Maximum number of results per request response page. Defaults to 30, meaning that 30 results are displayed per page. The maximum value is 10000.
pageToken Page token. Set pageToken to the nextPageToken returned by a previous request to get the next page of results.

Response

HTTP Code: 200 - OK

{
  "values": [
    "string"
  ],
  "metricsCount": "string",
  "absent": true,
  "nextPageToken": "string"
}
Field Description
values[] string

List of label values by the specified key.

metricsCount string (int64)

Number of metrics found by the specified selectors.

absent boolean (boolean)

Indicates that a selection contains metrics without the specified label.

nextPageToken string

Token to get the next page of results in a response.

Was the article helpful?

Language / Region
Yandex project
© 2023 Yandex.Cloud LLC
In this article:
  • HTTP request
  • Path parameters
  • Query parameters
  • Response