ENetrebin в 14:55, 18 октября 2022

2022-10-18T14:55:11Z

ENetrebin: Новая страница: « Вы можете создать предварительный просмотр перед выполнением фактического изменения...»

2022-10-17T13:00:48Z

Новая страница: « Вы можете создать предварительный просмотр перед выполнением фактического изменения...»

Новая страница

Вы можете создать предварительный просмотр перед выполнением фактического изменения конфигурации.

Предварительный просмотр говорит вам:

* Сколько объектов в настоящее время настроено, как описано в полезной нагрузке
* Сколько объектов будет настроено таким образом при отправке запроса на реконфигурацию

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

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

== Параметры ==
{| class="wikitable"
!Параметр
!Тип
!Описание
!В
!Необходимый
|-
|тело
|Операция удаленного управления конфигурацией Один запрос агента
|Тело запроса в формате JSON, содержащее определение задания удаленного управления конфигурацией.
|тело
|требуется
|}

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

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

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

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

* <code>group</code>
* <code>hostGroup</code>
* <code>networkZone</code>
|требуется
|-
|ценность
|нить
|Значение, которое должно быть присвоено данному атрибуту.
|по желанию
|-
|операция
|нить
|Операция, выполняемая над данным атрибутом.

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

* <code>clear</code>
* <code>set</code>
|требуется
|}

=== JSON-модель тела запроса ===
Это модель тела запроса, показывающая возможные элементы. Его необходимо настроить для использования в реальном запросе.
<code>{
"operations": [
{
"attribute": "networkZone",
"value": "exampleNetworkZoneName",
"operation": "set"
}
],
"entities": [
"HOST-D454A967666E7970",
"HOST-811760CFF2A5E872"
]
}</code>

== Ответ ==

=== Коды ответов ===
{| class="wikitable"
!Код
|Тип
!Описание
|-
|200
|Предварительный список удаленного управления конфигурацией
|Успех
|-
|400
|RemoteConfigurationManagementValidationResult
|Не удалось. Ввод недействителен.
|}

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

==== Объект _ <code>RemoteConfigurationManagementPreviewList</code> ====
Список предварительных просмотров заданий удаленного управления конфигурацией.
{| class="wikitable"
!Элемент
!Тип
!Описание
|-
|превью
|Предварительный просмотр задания удаленного управления конфигурацией []
|Список предварительных просмотров заданий удаленного управления конфигурацией.
|}

==== Объект _ <code>RemoteConfigurationManagementJobPreview</code> ====
Предварительный просмотр задания удаленного управления конфигурацией.
{| class="wikitable"
!Элемент
!Тип
!Описание
|-
|уже сконфигурированный EntitiesCount
|целое число
|Количество объектов, которые в настоящее время настроены в соответствии с операцией удаленного управления конфигурацией.
|-
|targetEntitiesCount
|целое число
|Количество объектов, которые будут настроены в соответствии с определением удаленного управления конфигурацией после его завершения.
|-
|атрибут
|нить
|Атрибут, на который влияет операция.

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

* <code>group</code>
* <code>hostGroup</code>
* <code>networkZone</code>
|-
|ценность
|нить
|Значение, которое должно быть присвоено данному атрибуту.
|-
|операция
|нить
|Операция, выполняемая над данным атрибутом.

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

* <code>clear</code>
* <code>set</code>
|}

=== JSON-модель тела ответа ===
<code>{
"previews": [
{
"alreadyConfiguredEntitiesCount": 1,
"targetEntitiesCount": 2,
"attribute": "networkZone",
"value": "exampleNetworkZoneName",
"operation": "set"
}
]
}</code>

GET текущая работа - История изменений

ENetrebin в 14:55, 18 октября 2022

ENetrebin: Новая страница: « Вы можете создать предварительный просмотр перед выполнением фактического изменения...»