listLabelValues method
Written by
Updated at October 29, 2025
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 | This is a required field. Label key used for the search. |
Query parameters
| Parameter | Description |
|---|---|
| folderId | This is a required field. Metric folder ID. The maximum string length is 50 characters. |
| selectors | Label selectors for metrics. |
| valueFilter | Substring for label value filtering. |
| pageSize | Maximum number of results per response page. The default value is 30. The maximum value is 10,000. |
| pageToken | Page token. To get the next result page, set pageToken to the nextPageToken value returned by the previous request. |
| fromTime | Optional parameter for selecting metrics from a specified time interval. It specifies the time interval start point in RFC3339 format. |
| toTime | Optional parameter for selecting metrics from a specified time interval. It specifies the time interval endpoint in RFC3339 format. |
The fromTime and toTime parameters are only used together. The response returns metrics that have data in the specified interval. To keep the index for such queries concise and efficient, the system:
- Ensures each response contains metric data for the period between the metric’s creation and its last record, even if there are gaps in the data.
- Updates the index every four to six hours for existing metrics. Adds new metrics immediately.
Response
HTTP Code: 200 - OK
{
"values": [
"string"
],
"metricsCount": "string",
"absent": true,
"nextPageToken": "string"
}
| Field | Description |
|---|---|
| values[] | string Labels for the specified key. |
| metricsCount | string (int64) Number of metrics found by the specified selectors. |
| absent | boolean (boolean) Indicates that the selection contains metrics without the specified label. |
| nextPageToken | string Token to get the next result page. |