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

Материал из Dynatrace
(Новая страница: « Запрос потребляет <code>application/json</code>полезную нагрузку. {| class="wikitable" | rowspan="3" |ПОЧТА |Удалось...»)
 
 
Строка 1: Строка 1:


 
Запрос использует в качестве полезной нагрузки <code>application/json</code> формат.
Запрос потребляет <code>application/json</code>полезную нагрузку.
{| class="wikitable"
{| class="wikitable"
| rowspan="3" |ПОЧТА
| rowspan="2" |POST
|Удалось
|Managed
|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/v2/activeGates/remoteConfigurationManagement</nowiki></code>
|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/v2/activeGates/remoteConfigurationManagement</nowiki></code>
|-
|-
|SaaS
|Среда АктивногоШлюза
|<code><nowiki>https://{your-environment-id}.live.dynatrace.com/api/v2/activeGates/remoteConfigurationManagement</nowiki></code>
|-
|Окружающая среда ActiveGate
|<code><nowiki>https://{your-activegate-domain}/e/{your-environment-id}/api/v2/activeGates/remoteConfigurationManagement</nowiki></code>
|<code><nowiki>https://{your-activegate-domain}/e/{your-environment-id}/api/v2/activeGates/remoteConfigurationManagement</nowiki></code>
|}
|}


== Аутентификация ==
== Аутентификация ==
Чтобы выполнить этот запрос, вам нужен токен доступа с областью действия Write ActiveGates ( <code>activeGates.write</code>) . Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация .
Чтобы выполнить этот запрос, вам нужен токен доступа с областью действия Write ActiveGates ( <code>activeGates.write</code>) . Чтобы узнать, как его получить и использовать, см. раздел [[Токены и аутентификация (API)|Токены и аутентификация]] .


== Параметры ==
== Параметры ==
Вы идентифицируете свои ActiveGate по их идентификаторам. Используйте запрос GET all ActiveGate , чтобы узнать идентификаторы ActiveGate, которые вы хотите настроить.
Вы идентифицируете свои АктивныеШлюзы по их идентификаторам. Используйте запрос GET all ActiveGate , чтобы узнать идентификаторы АктивногоШлюза, которые вы хотите настроить.
{| class="wikitable"
{| class="wikitable"
!Параметр
!Параметр
!Тип
!Тип
!Описание
!Описание
!В
!In
!Необходимый
!Необходимость
|-
|-
|тело
|body
|Операция удаленного управления конфигурацией Active Gate Request
|RemoteConfigurationManagementOperationActiveGateRequest
|Тело запроса в формате JSON, содержащее определение задания удаленного управления конфигурацией.
|Тело запроса в формате JSON, содержащее определение задания удаленного управления конфигурацией.
|тело
|body
|требуется
|требуется
|}
|}
Строка 35: Строка 31:
=== Объекты тела запроса ===
=== Объекты тела запроса ===


==== Объект _ <code>RemoteConfigurationManagementOperationActiveGateRequest</code> ====
==== Объект <code>RemoteConfigurationManagementOperationActiveGateRequest</code> ====
Запрос на создание операции удаленного управления конфигурацией.
Запрос на создание операции удаленного управления конфигурацией.
{| class="wikitable"
{| class="wikitable"
Строка 41: Строка 37:
!Тип
!Тип
!Описание
!Описание
!Необходимый
!Необходимость
|-
|-
|операции
|operations
|Операция удаленного управления конфигурацией []
|RemoteConfigurationManagementOperation[]
|Список операций удаленного управления конфигурацией, которые необходимо выполнить.
|Список операций удаленного управления конфигурацией, которые необходимо выполнить.
|требуется
|требуется
|-
|-
|сущности
|entities
|строка []
|string[]
|Список идентификаторов сущностей, для которых должно выполняться удаленное управление конфигурацией.
|Список идентификаторов объектов, для которых должно выполняться удаленное управление конфигурацией.
|требуется
|требуется
|}
|}


==== Объект _ <code>RemoteConfigurationManagementOperation</code> ====
==== Объект <code>RemoteConfigurationManagementOperation</code> ====
Определение одной операции удаленного управления конфигурацией.
Определение одной операции удаленного управления конфигурацией.
{| class="wikitable"
{| class="wikitable"
Строка 60: Строка 56:
!Тип
!Тип
!Описание
!Описание
!Необходимый
!Необходимость
|-
|-
|атрибут
|attribute
|нить
|string
|Атрибут, на который влияет операция.
|Атрибут, на который влияет операция.


Строка 73: Строка 69:
|требуется
|требуется
|-
|-
|ценность
|value
|нить
|string
|Значение, которое должно быть присвоено данному атрибуту.
|Значение, которое должно быть присвоено данному атрибуту.
|по желанию
|по желанию
|-
|-
|операция
|operation
|нить
|string
|Операция, выполняемая над данным атрибутом.
|Операция, выполняемая над данным атрибутом.


Строка 106: Строка 102:


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


=== Коды ответов ===
=== Коды ответов ===
Строка 115: Строка 111:
|-
|-
|201
|201
|Задание удаленного управления конфигурацией
|RemoteConfigurationManagementJob
|Созданный
|Создание
|-
|-
|400
|400
Строка 129: Строка 125:
=== Объекты тела ответа ===
=== Объекты тела ответа ===


==== Объект _ <code>RemoteConfigurationManagementJob</code> ====
==== Объект <code>RemoteConfigurationManagementJob</code> ====
Задание удаленного управления конфигурацией.
Задание удаленного управления конфигурацией.
{| class="wikitable"
{| class="wikitable"
!Элемент
|Element
!Тип
|Type
!Описание
!Описание
|-
|-
|тайм-аутВремя
|timeoutTime
|нить
|string
|Дата (в формате ISO 8601: гггг-ММ-дд'Т'ЧЧ:мм:сс.SSS'Z'), когда истечет время ожидания запущенного задания удаленного управления конфигурацией. Это поле присутствует только для запущенных заданий.
|Дата (в формате ISO 8601: гггг-ММ-дд'Т'ЧЧ:мм:сс.SSS'Z'), когда истечет время ожидания запущенного задания удаленного управления конфигурацией. Это поле присутствует только для запущенных заданий.
|-
|-
|обработаноEntitiesCount
|processedEntitiesCount
|целое число
|integer
|Количество объектов, которые уже были обработаны на момент создания ответа.
|Количество объектов, которые уже были обработаны на момент создания ответа.
|-
|-
|TotalEntitiesCount
|totalEntitiesCount
|целое число
|integer
|Общее количество объектов для обработки.
|Общее количество объектов для обработки.
|-
|-
|операции
|operations
|Операция удаленного управления конфигурацией []
|RemoteConfigurationManagementOperation[]
|Список выполненных заданий удаленного управления конфигурацией.
|Список выполненных заданий удаленного управления конфигурацией.
|-
|-
|тип объекта
|entityType
|нить
|string
|Тип объектов, измененных удаленным управлением конфигурацией.
|Тип объектов, измененных удаленным управлением конфигурацией.


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


==== Объект _ <code>RemoteConfigurationManagementOperation</code> ====
==== Объект <code>RemoteConfigurationManagementOperation</code> ====
Определение одной операции удаленного управления конфигурацией.
Определение одной операции удаленного управления конфигурацией.
{| class="wikitable"
{| class="wikitable"
Строка 181: Строка 177:
!Описание
!Описание
|-
|-
|атрибут
|attribute
|нить
|string
|Атрибут, на который влияет операция.
|Атрибут, на который влияет операция.


Строка 191: Строка 187:
* <code>networkZone</code>
* <code>networkZone</code>
|-
|-
|ценность
|value
|нить
|string
|Значение, которое должно быть присвоено данному атрибуту.
|Значение, которое должно быть присвоено данному атрибуту.
|-
|-
|операция
|operation
|нить
|string
|Операция, выполняемая над данным атрибутом.
|Операция, выполняемая над данным атрибутом.


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


Запрос потребляет <code>application/json</code>полезную нагрузку.
Запрос использует в качестве полезной нагрузки <code>application/json</code> формат.
{| class="wikitable"
{| class="wikitable"
| rowspan="3" |ПОЧТА
| rowspan="2" |POST
|Удалось
|Managed
|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/v2/activeGates/remoteConfigurationManagement/validator</nowiki></code>
|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/v2/activeGates/remoteConfigurationManagement/validator</nowiki></code>
|-
|-
|SaaS
|Среда АктивногоШлюза
|<code><nowiki>https://{your-environment-id}.live.dynatrace.com/api/v2/activeGates/remoteConfigurationManagement/validator</nowiki></code>
|-
|Окружающая среда ActiveGate
|<code><nowiki>https://{your-activegate-domain}/e/{your-environment-id}/api/v2/activeGates/remoteConfigurationManagement/validator</nowiki></code>
|<code><nowiki>https://{your-activegate-domain}/e/{your-environment-id}/api/v2/activeGates/remoteConfigurationManagement/validator</nowiki></code>
|}
|}


=== Аутентификация ===
=== Аутентификация ===
Чтобы выполнить этот запрос, вам нужен токен доступа с областью действия Write ActiveGates ( <code>activeGates.write</code>) . Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация .
Чтобы выполнить этот запрос, вам нужен токен доступа с областью действия Write ActiveGates ( <code>activeGates.write</code>) . Чтобы узнать, как его получить и использовать, см. раздел [[Токены и аутентификация (API)|Токены и аутентификация]] .


=== Ответ ===
=== Ответ ===

Текущая версия на 15:30, 18 октября 2022

Запрос использует в качестве полезной нагрузки application/json формат.

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

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

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

Параметры

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

Параметр Тип Описание In Необходимость
body RemoteConfigurationManagementOperationActiveGateRequest Тело запроса в формате JSON, содержащее определение задания удаленного управления конфигурацией. body требуется

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

Объект RemoteConfigurationManagementOperationActiveGateRequest

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

Элемент Тип Описание Необходимость
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": [
    "0x2b7c0b02",
    "0x4928065d"
  ]
}

Ответ

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

Коды ответов

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

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

Объект RemoteConfigurationManagementJob

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

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

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

  • ACTIVE_GATE
  • ONE_AGENT
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 Managed https://{your-domain}/e/{your-environment-id}/api/v2/activeGates/remoteConfigurationManagement/validator
Среда АктивногоШлюза https://{your-activegate-domain}/e/{your-environment-id}/api/v2/activeGates/remoteConfigurationManagement/validator

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

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

Ответ

Коды ответов

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