POST тэгов**: различия между версиями

Материал из Dynatrace
 
Строка 26: Строка 26:
|meIdentifier
|meIdentifier
|string
|string
|Идентификатор объекта Ключ-АСТРОМ службы, которую вы запрашиваете.
|Идентификатор объекта Dynatrace службы, которую вы запрашиваете.
|path
|path
|требуется
|требуется
Строка 32: Строка 32:
|body
|body
|UpdateEntity
|UpdateEntity
|Список тегов, которые должны быть назначены объекту Ключ-АСТРОМ.
|Список тегов, которые должны быть назначены объекту Dynatrace.
|body
|body
|по желанию
|по желанию
Строка 40: Строка 40:


==== Объект <code>UpdateEntity</code> ====
==== Объект <code>UpdateEntity</code> ====
Список тегов, которые должны быть назначены объекту Ключ-АСТРОМ.
Список тегов, которые должны быть назначены объекту Dynatrace.
{| class="wikitable"
{| class="wikitable"
!Элемент
!Элемент
Строка 49: Строка 49:
|tags
|tags
|string []
|string []
|Список тегов, которые должны быть назначены объекту Ключ-АСТРОМ.
|Список тегов, которые должны быть назначены объекту Dynatrace.
|требуется
|требуется
|}
|}
Строка 86: Строка 86:
==== Curl ====
==== Curl ====
  <code>curl -X POST \
  <code>curl -X POST \
   <nowiki>https://mySampleEnv.live.ruscomtech.ru/api/v1/entity/services/SERVICE-72503CBDD2AEF066</nowiki> \
   <nowiki>https://mySampleEnv.live.dynatrace.com/api/v1/entity/services/SERVICE-72503CBDD2AEF066</nowiki> \
   -H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890' \
   -H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890' \
   -H 'Content-Type: application/json' \
   -H 'Content-Type: application/json' \
Строка 96: Строка 96:


==== URL-адрес запроса ====
==== URL-адрес запроса ====
  <code><nowiki>https://mySampleEnv.live.ruscomtech.ru/api/v1/entity/services/SERVICE-72503CBDD2AEF066</nowiki></code>
  <code><nowiki>https://mySampleEnv.live.dynatrace.com/api/v1/entity/services/SERVICE-72503CBDD2AEF066</nowiki></code>


==== Тело запроса ====
==== Тело запроса ====

Текущая версия на 14:32, 3 февраля 2023

Назначает пользовательские теги указанной службе. Вам нужно указать только значение тега. Контекст CONTEXTLESSбудет назначен автоматически.

Использование этого API ограничено тегами только со значениями. Чтобы назначить теги ключ:значение, используйте API пользовательских тегов .

Запрос потребляет application/jsonполезную нагрузку.

POST Managed https://{your-domain}/e/{your-environment-id}/api/v1/entity/services/{meIdentifier}
Cреда АктивногоШлюза https://{your-activegate-domain}/e/{your-environment-id}/api/v1/entity/services/{meIdentifier}

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

Чтобы выполнить этот запрос, вам нужен токен доступа с проблемой доступа и каналом событий, метриками и областью топологии ( DataExport) . Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация .

Параметры

Параметр Тип Описание In Необходимость
meIdentifier string Идентификатор объекта Dynatrace службы, которую вы запрашиваете. path требуется
body UpdateEntity Список тегов, которые должны быть назначены объекту Dynatrace. body по желанию

Объекты тела запроса

Объект UpdateEntity

Список тегов, которые должны быть назначены объекту Dynatrace.

Элемент Тип Описание Необходимость
tags string [] Список тегов, которые должны быть назначены объекту Dynatrace. требуется

JSON-модель тела запроса

Это модель тела запроса, показывающая возможные элементы. Его необходимо настроить для использования в реальном запросе.

{
  "tags": [
    "office-linz",
    "office-klagenfurt"
  ]
}

Ответ

Коды ответов

Код Тип Описание
204 Успех. Параметры сервиса обновлены.
400 ErrorEnvelope Не удалось. Ввод недействителен.

Пример

В этом примере запрос присваивает PHP - тег PHP-FPM через сервис доменного сокета /run/php7-fpm.sock , который имеет идентификатор SERVICE-72503CBDD2AEF066 .

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

Curl

curl -X POST \
  https://mySampleEnv.live.dynatrace.com/api/v1/entity/services/SERVICE-72503CBDD2AEF066 \
  -H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890' \
  -H 'Content-Type: application/json' \
  -d '{
  "tags": [
    "PHP"
  ]
}'

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

https://mySampleEnv.live.dynatrace.com/api/v1/entity/services/SERVICE-72503CBDD2AEF066

Тело запроса

{
  "tags": [
    "PHP"
  ]
}

Код ответа

204