Метод listLabelValues
Статья создана
Обновлена 15 октября 2025 г.
Возвращает список значений для указанного ключа метки.
HTTP-запрос
GET https://monitoring.api.cloud.yandex.net/monitoring/v2/metrics/labels/{labelKey}/values
Path-параметры
| Параметр | Описание |
|---|---|
| labelKey | Обязательное поле. Ключ метки, по которому осуществляется поиск. |
Query-параметры
| Параметр | Описание |
|---|---|
| folderId | Обязательное поле. Идентификатор каталога, которому принадлежит метрика. Максимальная длина строки в символах — 50. |
| selectors | Селекторы метрики для поиска по меткам. |
| valueFilter | Текст подстроки для фильтрации по значению меток. |
| pageSize | Максимальное количество результатов на странице ответа на запрос. Значение по умолчанию — 0, на странице будет показано 30 результатов. Максимальное значение — 10000. |
| pageToken | Токен страницы. Установите значение pageToken равным значению поля nextPageToken предыдущего запроса, чтобы получить следующую страницу результатов. |
| fromTime | Необязательный параметр, позволяет выбрать метрики из заданного интервала времени. Задает начало интервала в формате RFC3339. |
| toTime | Необязательный параметр, позволяет выбрать метрики из заданного интервала времени. Задает конец интервала в формате RFC3339. |
Параметры fromTime и toTime используются только вместе. В ответе возвращаются метрики, у которых есть данные в указанном интервале. Чтобы индекс для таких запросов оставался компактным и производительным:
- Метрика включается в ответ за весь период от ее создания до последней записи, даже если в данных были пропуски.
- Индекс обновляется каждые 4–6 часов для существующих метрик. Новые метрики добавляются сразу.
Ответ
HTTP Code: 200 - OK
{
"values": [
"string"
],
"metricsCount": "string",
"absent": true,
"nextPageToken": "string"
}
| Поле | Описание |
|---|---|
| values[] | string Список значений меток по заданному ключу. |
| metricsCount | string (int64) Число метрик, которые найдены по заданным селекторам. |
| absent | boolean (boolean) Указывает, что в выборке есть метрики без заданной метки. |
| nextPageToken | string Токен для получения следующей страницы результатов в ответе. |