POST тэгов*: различия между версиями
ENetrebin (обсуждение | вклад) (Новая страница: «Назначает пользовательские теги указанной группе процессов . Вам нужно только указать з...») |
ENetrebin (обсуждение | вклад) |
||
(не показана 1 промежуточная версия этого же участника) | |||
Строка 21: | Строка 21: | ||
!Тип | !Тип | ||
!Описание | !Описание | ||
! | !In | ||
! | !Необходимость | ||
|- | |- | ||
|meIdentifier | |meIdentifier | ||
|string | |string | ||
|Идентификатор объекта | |Идентификатор объекта Dynatrace для группы процессов, которую необходимо обновить. | ||
| | |path | ||
|требуется | |требуется | ||
|- | |- | ||
| | |body | ||
| | |UpdateEntity | ||
|Тело JSON запроса. Содержит теги, которые необходимо добавить в группу процессов. | |Тело JSON запроса. Содержит теги, которые необходимо добавить в группу процессов. | ||
| | |body | ||
|по желанию | |по желанию | ||
|} | |} | ||
Строка 39: | Строка 39: | ||
=== Объекты тела запроса === | === Объекты тела запроса === | ||
==== Объект | ==== Объект <code>UpdateEntity</code> ==== | ||
Список тегов, которые должны быть назначены объекту | Список тегов, которые должны быть назначены объекту Dynatrace. | ||
{| class="wikitable" | {| class="wikitable" | ||
!Элемент | !Элемент | ||
!Тип | !Тип | ||
!Описание | !Описание | ||
! | !Необходимость | ||
|- | |- | ||
| | |tags | ||
| | |string [] | ||
|Список тегов, которые должны быть назначены объекту | |Список тегов, которые должны быть назначены объекту Dynatrace. | ||
|требуется | |требуется | ||
|} | |} | ||
Строка 86: | Строка 86: | ||
==== Завиток ==== | ==== Завиток ==== | ||
<code>curl -X POST \ | <code>curl -X POST \ | ||
<nowiki>https://mySampleEnv.live. | <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. | <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