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

Версия от 08:52, 26 декабря 2024

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

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

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

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

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

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

Параметры

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

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

Объект `UpdateEntity`

Список тегов, которые должны быть назначены объекту Ключ-АСТРОМ.

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

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

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

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

Ответ

Коды ответов

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

Пример

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

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

Завиток

<curl -X POST \
  https://mySampleEnv.live.ruscomtech.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.ruscomtech.com/api/v1/entity/infrastructure/process-groups/PROCESS_GROUP-E5C3CC7EC1F80B5B

Тело запроса

<{
  "tags": [
    "PHP"
  ]
}

Код ответа

204

@@ Строка 6: / Строка 6: @@
 {| class="wikitable"
 | rowspan="2" |POST
-|Managed
+|АппОптима
 |<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/v1/entity/infrastructure/process-groups/{meIdentifier}</nowiki></code>
 |-
@@ Строка 55: / Строка 55: @@
 === JSON-модель тела запроса ===
 Это модель тела запроса, показывающая возможные элементы. Его необходимо настроить для использования в реальном запросе.
-  <code>{
+  <{
     "tags": [
       "office-linz",
@@ Строка 85: / Строка 85: @@
 ==== Завиток ====
-  <code>curl -X POST \
+  <curl -X POST \
     <nowiki>https://mySampleEnv.live.ruscomtech.com/api/v1/entity/infrastructure/process-groups/PROCESS_GROUP-E5C3CC7EC1F80B5B</nowiki> \
     -H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890' \
@@ Строка 99: / Строка 99: @@
 ==== Тело запроса ====
-  <code>{
+  <{
     "tags": [
       "PHP"