GET одной единицы метрик: различия между версиями
Материал из Dynatrace
ENetrebin (обсуждение | вклад) (Новая страница: «Возвращает свойства единицы метрики. Запрос выдает <code>application/json</code>полезную нагрузку. {|...») |
ENetrebin (обсуждение | вклад) |
||
Строка 92: | Строка 92: | ||
==== Curl ==== | ==== Curl ==== | ||
<code>curl --request GET \ | <code>curl --request GET \ | ||
--url <nowiki>https://mySampleEnv.live. | --url <nowiki>https://mySampleEnv.live.dynatrace.com//api/v2/units/MebiByte</nowiki> \ | ||
--header 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'</code> | --header 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'</code> | ||
==== URL-адрес запроса ==== | ==== URL-адрес запроса ==== | ||
<code><nowiki>https://mySampleEnv.live. | <code><nowiki>https://mySampleEnv.live.dynatrace.com//api/v2/units/MebiByte</nowiki></code> | ||
==== Тело ответа ==== | ==== Тело ответа ==== |
Текущая версия на 15:51, 2 февраля 2023
Возвращает свойства единицы метрики.
Запрос выдает application/json
полезную нагрузку.
GET | Managed | https://{your-domain}/e/{your-environment-id}/api/v2/units/{unitId}
|
Среда АктивногоШлюза | 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.dynatrace.com//api/v2/units/MebiByte \
--header 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'
URL-адрес запроса
https://mySampleEnv.live.dynatrace.com//api/v2/units/MebiByte
Тело ответа
{
"unitId": "MebiByte",
"displayName": "mebibyte",
"symbol": "MiB",
"description": "1048576.0 byte"
}
Код ответа
200