IKuznetsov в 16:26, 2 января 2025

2025-01-02T16:26:02Z

← Предыдущая версия		Версия от 16:26, 2 января 2025
Строка 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 предпросмотр работы'''''

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

Строка 104:		Строка 106:
	"HOST-811760CFF2A5E872"		"HOST-811760CFF2A5E872"
	]		]
	}~~</code>~~		}

	== Ответ ==		== Ответ ==
Строка 187:		Строка 189:
	}		}
	]		]
	}~~</code>~~		}

IKuznetsov в 21:05, 25 декабря 2024

2024-12-25T21:05:09Z

← Предыдущая версия		Версия от 21:05, 25 декабря 2024
Строка 9:		Строка 9:
	{\| class="wikitable"		{\| class="wikitable"
	\| rowspan="2" \|POST		\| rowspan="2" \|POST
	\|~~Managed~~		\|АппОптима
	\|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/v2/oneagents/remoteConfigurationManagement/preview</nowiki></code>		\|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/v2/oneagents/remoteConfigurationManagement/preview</nowiki></code>
	\|-		\|-
Строка 92:		Строка 92:
	=== JSON-модель тела запроса ===		=== JSON-модель тела запроса ===
	Это модель тела запроса, показывающая возможные элементы. Его необходимо настроить для использования в реальном запросе.		Это модель тела запроса, показывающая возможные элементы. Его необходимо настроить для использования в реальном запросе.
	<~~code>~~{		<{
	"operations": [		"operations": [
	{		{
Строка 177:		Строка 177:

	=== JSON-модель тела ответа ===		=== JSON-модель тела ответа ===
	<~~code>~~{		<{
	"previews": [		"previews": [
	{		{

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

2022-10-18T14:40:44Z

Внесённые изменения

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

2022-10-17T12:59:16Z

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

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

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

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

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

Запрос потребляет <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>

POST предпросмотр работы - История изменений

IKuznetsov в 16:26, 2 января 2025

IKuznetsov в 21:05, 25 декабря 2024

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

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