Открыть поиск
Открыть меню
837
701
11
7,1 тыс.
Документация АппОптима
Открыть персональное меню
Вы не представились системе
Your IP address will be publicly visible if you make any edits.

POST задание конфигурации: различия между версиями

Материал из Документация АппОптима
Дополнительные действия
Нет описания правки
Нет описания правки
 
(не показана 1 промежуточная версия этого же участника)
Строка 1: Строка 1:


'''''[[API АппОптима]] / [[API АппОптима|Эндпойнты среды]] / [https://docs.expert-apm.ru/index.php/API_%D0%90%D0%BF%D0%BF%D0%9E%D0%BF%D1%82%D0%B8%D0%BC%D0%B0#:~:text=DELETE%20%D1%82%D0%B5%D0%B3%D0%BE%D0%B2-,%D0%A0%D0%B0%D0%B7%D0%B2%D1%91%D1%80%D1%82%D1%8B%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5,-%D0%BF%D1%80%D0%B0%D0%B2%D0%B8%D1%82%D1%8C Развёртывание] / [https://docs.expert-apm.ru/index.php/API_%D0%90%D0%BF%D0%BF%D0%9E%D0%BF%D1%82%D0%B8%D0%BC%D0%B0#:~:text=%D0%A3%D0%B4%D0%B0%D0%BB%D1%91%D0%BD%D0%BD%D0%BE%D0%B5%20%D1%83%D0%BF%D1%80%D0%B0%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5%20%D0%BA%D0%BE%D0%BD%D1%84%D0%B8%D0%B3%D1%83%D1%80%D0%B0%D1%86%D0%B8%D0%B5%D0%B9 Удалённое управление конфигурацией] / [https://docs.expert-apm.ru/index.php/API_%D0%90%D0%BF%D0%BF%D0%9E%D0%BF%D1%82%D0%B8%D0%BC%D0%B0#:~:text=%D0%A3%D0%B4%D0%B0%D0%BB%D1%91%D0%BD%D0%BD%D0%BE%D0%B5%20%D1%83%D0%BF%D1%80%D0%B0%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5%20%D0%BA%D0%BE%D0%BD%D1%84%D0%B8%D0%B3%D1%83%D1%80%D0%B0%D1%86%D0%B8%D0%B5%D0%B9-,%D0%95%D0%B4%D0%B8%D0%BD%D1%8B%D0%B9%D0%90%D0%B3%D0%B5%D0%BD%D1%82,-POST%20%D0%B7%D0%B0%D0%B4%D0%B0%D0%BD%D0%B8%D0%B5%20%D0%BA%D0%BE%D0%BD%D1%84%D0%B8%D0%B3%D1%83%D1%80%D0%B0%D1%86%D0%B8%D0%B8 ЕдиныйАгент] / POST задание конфигурации'''''


Запрос потребляет <code>application/json</code>полезную нагрузку.
Запрос потребляет <code>application/json</code>полезную нагрузку.
{| class="wikitable"
{| class="wikitable"
| rowspan="2" |POST
| rowspan="2" |POST
|Managed
|АппОптима
|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/v2/oneagents/remoteConfigurationManagement</nowiki></code>
|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/v2/oneagents/remoteConfigurationManagement</nowiki></code>
|-
|-
Строка 94: Строка 95:
=== JSON-модель тела запроса ===
=== JSON-модель тела запроса ===
Это модель тела запроса, показывающая возможные элементы. Его необходимо настроить для использования в реальном запросе.
Это модель тела запроса, показывающая возможные элементы. Его необходимо настроить для использования в реальном запросе.
  <code>{
  <{
   "operations": [
   "operations": [
     {
     {
Строка 106: Строка 107:
     "HOST-811760CFF2A5E872"
     "HOST-811760CFF2A5E872"
   ]
   ]
  }</code>
  }


== Ответ ==
== Ответ ==
Строка 205: Строка 206:


=== JSON-модель тела ответа ===
=== JSON-модель тела ответа ===
  <code>{
  <{
   "timeoutTime": "2020-11-05T08:15:30.144Z",
   "timeoutTime": "2020-11-05T08:15:30.144Z",
   "processedEntitiesCount": 1,
   "processedEntitiesCount": 1,
Строка 220: Строка 221:
   "startTime": "2020-11-05T08:15:30.144Z",
   "startTime": "2020-11-05T08:15:30.144Z",
   "endTime": "2020-11-05T08:15:30.144Z"
   "endTime": "2020-11-05T08:15:30.144Z"
  }</code>
  }
Ответ не отправляется клиенту до тех пор, пока не будут обработаны все ЕдиныеАгенты, определенные в полезной нагрузке. ЕдиныйАгент считается обработанным, когда ему отправляется сообщение о реконфигурации; фактическая реконфигурация выполняется независимо от ЕдиногоАгента.
Ответ не отправляется клиенту до тех пор, пока не будут обработаны все ЕдиныеАгенты, определенные в полезной нагрузке. ЕдиныйАгент считается обработанным, когда ему отправляется сообщение о реконфигурации; фактическая реконфигурация выполняется независимо от ЕдиногоАгента.


Строка 229: Строка 230:
{| class="wikitable"
{| class="wikitable"
| rowspan="2" |POST
| rowspan="2" |POST
|Managed
|АппОптима
|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/v2/oneagents/remoteConfigurationManagement/validator</nowiki></code>
|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/v2/oneagents/remoteConfigurationManagement/validator</nowiki></code>
|-
|-

Текущая версия от 16:25, 2 января 2025

API АппОптима / Эндпойнты среды / Развёртывание / Удалённое управление конфигурацией / ЕдиныйАгент / POST задание конфигурации

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

POST АппОптима https://{your-domain}/e/{your-environment-id}/api/v2/oneagents/remoteConfigurationManagement
Cреда АктивногоШлюза https://{your-activegate-domain}/e/{your-environment-id}/api/v2/oneagents/remoteConfigurationManagement

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

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

Параметры

Вы идентифицируете своих ЕдиныхАгентов по их идентификаторам. Используйте ЕдиныйАгент в запросе хоста, чтобы узнать идентификаторы ЕдиногоАгента, которые вы хотите настроить.

Параметр Тип Описание In Необходимость
restart boolean Если установлено значение false, ЕдиныеАгенты не будет перезапущен после применения конфигурации. query по желанию
body RemoteConfigurationManagementOperationOneAgentRequest Тело запроса в формате JSON, содержащее определение задания удаленного управления конфигурацией. body требуется

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

Объект RemoteConfigurationManagementOperationOneAgentRequest

Запрос на создание операции удаленного управления конфигурацией.

Элемент Тип Описание Необходимость
operations RemoteConfigurationManagementOperation[] Список операций удаленного управления конфигурацией, которые необходимо выполнить. требуется
entities string [] Список идентификаторов объектов, для которых должно выполняться удаленное управление конфигурацией. требуется

Объект RemoteConfigurationManagementOperation

Определение одной операции удаленного управления конфигурацией.

Элемент Тип Описание Необходимый
attribute string Атрибут, на который влияет операция.

Элемент может содержать эти значения

  • group
  • hostGroup
  • networkZone
 требуется
value string Значение, которое должно быть присвоено данному атрибуту. по желанию
operation string Операция, выполняемая над данным атрибутом.

Элемент может содержать эти значения

  • clear
  • set
 требуется

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

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

<{
  "operations": [
    {
      "attribute": "networkZone",
      "value": "exampleNetworkZoneName",
      "operation": "set"
    }
  ],
  "entities": [
    "HOST-D454A967666E7970",
    "HOST-811760CFF2A5E872"
  ]
}

Ответ

Коды ответов

Код Тип Описание
201 RemoteConfigurationManagementJob Созданный
400 RemoteConfigurationManagementValidationResult Не удалось. Ввод недействителен.
409 В настоящее время выполняется другое задание удаленного управления конфигурацией.

Объекты тела ответа

Объект RemoteConfigurationManagementJob

Задание удаленного управления конфигурацией.

Элемент Тип Описание
timeoutTime string Дата (в формате ISO 8601: гггг-ММ-дд'Т'ЧЧ:мм:сс.SSS'Z'), когда истечет время ожидания запущенного задания удаленного управления конфигурацией. Это поле присутствует только для запущенных заданий.
processedEntitiesCount integer Количество объектов, которые уже были обработаны на момент создания ответа.
totalEntitiesCount integer Общее количество объектов для обработки.
operations RemoteConfigurationManagementOperation[] Список выполненных заданий удаленного управления конфигурацией.
entityType string Тип объектов, измененных удаленным управлением конфигурацией.

Элемент может содержать эти значения

id string Идентификатор задания удаленного управления конфигурацией.
startTime string Дата (в формате ISO 8601: гггг-ММ-дд'Т'ЧЧ:мм:сс.ССС'Z') запуска задания удаленного управления конфигурацией.
endTime string Дата (в формате ISO 8601: гггг-ММ-дд'Т'ЧЧ:мм:сс.ССС'Z') завершения задания удаленного управления конфигурацией. Это поле присутствует только для готовых работ.

Объект RemoteConfigurationManagementOperation

Определение одной операции удаленного управления конфигурацией.

Элемент Тип Описание
attribute string Атрибут, на который влияет операция.

Элемент может содержать эти значения

  • group
  • hostGroup
  • networkZone
value string Значение, которое должно быть присвоено данному атрибуту.
operation string Операция, выполняемая над данным атрибутом.

Элемент может содержать эти значения

  • clear
  • set

JSON-модель тела ответа

<{
  "timeoutTime": "2020-11-05T08:15:30.144Z",
  "processedEntitiesCount": 1,
  "totalEntitiesCount": 1,
  "operations": [
    {
      "attribute": "networkZone",
      "value": "exampleNetworkZoneName",
      "operation": "set"
    }
  ],
  "entityType": "ACTIVE_GATE or ONE_AGENT",
  "id": "7974003406714390819",
  "startTime": "2020-11-05T08:15:30.144Z",
  "endTime": "2020-11-05T08:15:30.144Z"
}

Ответ не отправляется клиенту до тех пор, пока не будут обработаны все ЕдиныеАгенты, определенные в полезной нагрузке. ЕдиныйАгент считается обработанным, когда ему отправляется сообщение о реконфигурации; фактическая реконфигурация выполняется независимо от ЕдиногоАгента.

Проверка полезную нагрузку

Мы рекомендуем вам проверить полезную нагрузку перед ее отправкой с фактическим запросом. Код ответа 204 указывает на действительную полезную нагрузку.

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

POST АппОптима https://{your-domain}/e/{your-environment-id}/api/v2/oneagents/remoteConfigurationManagement/validator
Cреда АктивногоШлюза https://{your-activegate-domain}/e/{your-environment-id}/api/v2/oneagents/remoteConfigurationManagement/validator

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

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

Ответ

Коды ответов

Код Тип Описание
204 Успех. Ответ не имеет тела.
400 RemoteConfigurationManagementValidationResult Не удалось. Ввод недействителен.
Источник — https://docs.expert-apm.ru/index.php?title=POST_задание_конфигурации&oldid=6207
Последнее изменение