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

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


==== Объект <code>UpdateEntity</code> ====
==== Объект <code>UpdateEntity</code> ====
Список тегов, которые должны быть назначены объекту Ключ-АСТРОМ.
Список тегов, которые должны быть назначены объекту Dynatrace.
{| class="wikitable"
{| class="wikitable"
!Элемент
!Элемент
Строка 49: Строка 49:
|tags
|tags
|string []
|string []
|Список тегов, которые должны быть назначены объекту Ключ-АСТРОМ.
|Список тегов, которые должны быть назначены объекту Dynatrace.
|требуется
|требуется
|}
|}
Строка 86: Строка 86:
==== Завиток ====
==== Завиток ====
  <code>curl -X POST \
  <code>curl -X POST \
   <nowiki>https://mySampleEnv.live.ruscomtech.com/api/v1/entity/infrastructure/process-groups/PROCESS_GROUP-E5C3CC7EC1F80B5B</nowiki> \
   <nowiki>https://mySampleEnv.live.dynatrace.com/api/v1/entity/infrastructure/process-groups/PROCESS_GROUP-E5C3CC7EC1F80B5B</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.com/api/v1/entity/infrastructure/process-groups/PROCESS_GROUP-E5C3CC7EC1F80B5B</nowiki></code>
  <code><nowiki>https://mySampleEnv.live.dynatrace.com/api/v1/entity/infrastructure/process-groups/PROCESS_GROUP-E5C3CC7EC1F80B5B</nowiki></code>


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

Текущая версия на 16:48, 2 февраля 2023

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

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

Запрос производитapplication/json

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

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

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

Параметры

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

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

Объект UpdateEntity

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

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

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

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

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

Ответ

Коды ответов

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

Пример

В этом примере запрос назначает тег PHP группе процессов PHP-FPM с идентификатором PROCESS_GROUP-E5C3CC7EC1F80B5B .

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

Завиток

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

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

https://mySampleEnv.live.dynatrace.com/api/v1/entity/infrastructure/process-groups/PROCESS_GROUP-E5C3CC7EC1F80B5B

Тело запроса

{
  "tags": [
    "PHP"
  ]
}

Код ответа

204