GET одной единицы метрик: различия между версиями

Текущая версия от 12:22, 29 декабря 2024

API АппОптима / Эндпойнты среды / Развёртывание / Единицы метрик / GET одной единицы метрик

Возвращает свойства единицы метрики.

Запрос выдает application/jsonполезную нагрузку.

GET	АппОптима	`https://{your-domain}/e/{your-environment-id}/api/v2/units/{unitId}`
GET	Среда АктивногоШлюза	`https://{your-activegate-domain}/e/{your-environment-id}/api/v2/units/{unitId}`

Аутентификация

Для выполнения этого запроса вам нужен токен доступа с метриками чтения (metrics.read)

Параметры

Параметр	Тип	Описание	In	Требуется
nitId	string	Идентификатор требуемого устройства.	path	требуется

Ответная реакция

Коды ответов

Код	Тип	Описание
200		Успех
404		Не найдено. Запрошенный ресурс не найден или запрос неверен.

Объекты тела ответа

The `Unit`

Метаданные единицы измерения.

Элемент	Тип	Описание
unitId	string	Идентификатор устройства.
displayName	string	Отображаемое имя единицы измерения.
symbol	string	Символ единицы измерения.
description	string	Краткое описание единицы измерения.
displayNamePlural	string	Отображаемое имя единицы измерения во множественном числе.

JSON-модель тела ответа

<{
  "unitId": "Second",
  "displayName": "second",
  "displayNamePlural": "seconds",
  "symbol": "s",
  "description": "The second is the base unit of time and defined as 1/86400 of a day."
}

Пример

В этом примере запрос извлекает метаданные единицы измерения отношения.

Токен API передается в заголовке авторизации.

Curl

<curl --request GET \
  --url https://mySampleEnv.live.ruscomtech.ru//api/v2/units/MebiByte \
  --header 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'

URL-адрес запроса

https://mySampleEnv.live.ruscomtech.ru//api/v2/units/MebiByte

Тело ответа

<{
  "unitId": "MebiByte",
  "displayName": "mebibyte",
  "symbol": "MiB",
  "description": "1048576.0 byte"
}

Код ответа

200

@@ Строка 1: / Строка 1: @@
+'''''[[API АппОптима]] / [[API АппОптима|Эндпойнты среды]] / [https://docs.expert-apm.ru/index.php/API_%D0%90%D0%BF%D0%BF%D0%9E%D0%BF%D1%82%D0%B8%D0%BC%D0%B0#:~:text=DELETE%20%D1%82%D0%B5%D0%B3%D0%BE%D0%B2-,%D0%A0%D0%B0%D0%B7%D0%B2%D1%91%D1%80%D1%82%D1%8B%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5,-%D0%BF%D1%80%D0%B0%D0%B2%D0%B8%D1%82%D1%8C Развёртывание] / [https://docs.expert-apm.ru/index.php/API_%D0%90%D0%BF%D0%BF%D0%9E%D0%BF%D1%82%D0%B8%D0%BC%D0%B0#:~:text=FAQ-,%D0%95%D0%B4%D0%B8%D0%BD%D0%B8%D1%86%D1%8B%20%D0%BC%D0%B5%D1%82%D1%80%D0%B8%D0%BA,-GET%20%D0%B2%D1%81%D0%B5%D1%85%20%D0%B5%D0%B4%D0%B8%D0%BD%D0%B8%D1%86 Единицы метрик] / GET одной единицы метрик'''''
 Возвращает свойства единицы метрики.
@@ Строка 83: / Строка 85: @@
     "symbol": "s",
     "description": "The second is the base unit of time and defined as 1/86400 of a day."
-  }</code>
+  }
 == Пример ==
@@ Строка 93: / Строка 95: @@
   <curl --request GET \
     --url <nowiki>https://mySampleEnv.live.ruscomtech.ru//api/v2/units/MebiByte</nowiki> \
-    --header 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'</code>
+    --header 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'
 ==== URL-адрес запроса ====
@@ Строка 104: / Строка 106: @@
     "symbol": "MiB",
     "description": "1048576.0 byte"
-  }</code>
+  }
 ==== Код ответа ====