Редактировать АктивныйШлюз: различия между версиями

Материал из Документация Ключ-АСТРОМ
(Новая страница: «Редактирует конфигурацию автообновления указанной среды ActiveGate. Запрос потребляет <code>ap...»)
 
 
(не показаны 4 промежуточные версии этого же участника)
Строка 1: Строка 1:
Редактирует конфигурацию автообновления указанной среды ActiveGate.
'''''[[API Ключ-АСТРОМ]] / [[API Ключ-АСТРОМ#.D0.AD.D0.BD.D0.B4.D0.BF.D0.BE.D0.B9.D0.BD.D1.82.D1.8B%20.D1.81.D1.80.D0.B5.D0.B4.D1.8B|Эндпойнты среды]] / [[API Ключ-АСТРОМ#.D0.90.D0.BA.D1.82.D0.B8.D0.B2.D0.BD.D1.8B.D0.B5.D0.A8.D0.BB.D1.8E.D0.B7.D1.8B|АктивныеШлюзы]] / Конфигурация автообновления / Редактировать АктивныйШлюз'''''
 
Редактирует конфигурацию автообновления указанной среды АктивногоШлюза.  


Запрос потребляет <code>application/json</code>полезную нагрузку.
Запрос потребляет <code>application/json</code>полезную нагрузку.
{| class="wikitable"
{| class="wikitable"
|СТАВИТЬ
|PUT
|
|
* Удалось https: // {ваш-домен} / e / {ваш-идентификатор-среды} / api / v2 / activeGates / {agId} / autoUpdate
* Managed https: // {ваш-домен} / e / {ваш-идентификатор-среды} / api / v2 / activeGates / {agId} / autoUpdate
* SaaS https: // {ваш-идентификатор-среды} .live.dynatrace.com / api / v2 / activeGates / {agId} / autoUpdate
* Среда АктивногоШлюза https: // {your-activegate-domain} / e / {your-environment-id} / api / v2 / activeGates / {agId} / autoUpdate
* Среда ActiveGate https: // {your-activegate-domain} / e / {your-environment-id} / api / v2 / activeGates / {agId} / autoUpdate
|}
|}


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


== Параметры ==
== Параметры ==
Строка 18: Строка 19:
!Тип
!Тип
!Описание
!Описание
!В
!In
!необходимые
!необходимость
|-
|-
|стареть
|старение
|нить
|string
|ID необходимого ActiveGate.
|ID необходимого АктивногоШлюза.
|дорожка
|path
|обязательный
|обязательный
|-
|-
|тело
|body
|Активный Gate Auto Update Config
|АктивныйШлюз Auto Update Config
|Тело запроса в формате JSON, содержащее параметры автообновления.
|Тело запроса в формате JSON, содержащее параметры автообновления.
|тело
|body
|по желанию
|по желанию
|}
|}
Строка 39: Строка 40:


==== ActiveGateAutoUpdateConfig объект ====
==== ActiveGateAutoUpdateConfig объект ====
Настройка автообновлений ActiveGate.
Настройка автообновлений АктивногоШлюза.
{| class="wikitable"
{| class="wikitable"
!Элемент
!Элемент
Строка 47: Строка 48:
|-
|-
|параметр
|параметр
|нить
|string
|Состояние автообновления ActiveGate: включено, отключено или унаследовано.
|Состояние автообновления АктивногоШлюза: включено, отключено или унаследовано.


Если установлено значение <code>INHERITED</code>, параметр наследуется из глобальной конфигурации, установленной на уровне среды или управляемого кластера.
Если установлено значение <code>INHERITED</code>, параметр наследуется из глобальной конфигурации, установленной на уровне среды или управляемого кластера.
Строка 54: Строка 55:
Элемент может содержать эти значения
Элемент может содержать эти значения


* ИНВАЛИД
* invalid
* ВКЛЮЧЕНО
* ВКЛЮЧЕНО
* Унаследованный
* Унаследованный
Строка 90: Строка 91:
Запрос потребляет <code>application/json</code>полезную нагрузку.
Запрос потребляет <code>application/json</code>полезную нагрузку.
{| class="wikitable"
{| class="wikitable"
|ПОЧТА
|POST
|
|
* Удалось https: // {ваш-домен} / e / {your-environment-id} / api / v2 / activeGates / {agId} / autoUpdate / validator
* Managed https: // {ваш-домен} / e / {your-environment-id} / api / v2 / activeGates / {agId} / autoUpdate / validator
* SaaS https: // {your-environment-id} .live.dynatrace.com / api / v2 / activeGates / {agId} / autoUpdate / validator.
* Среда АктивногоШлюза https: // {your-activegate-domain} / e / {your-environment-id} / api / v2 / activeGates / {agId} / autoUpdate / validator
* Среда ActiveGate https: // {your-activegate-domain} / e / {your-environment-id} / api / v2 / activeGates / {agId} / autoUpdate / validator
|}
|}


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


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

Текущая версия на 18:14, 2 июня 2024

API Ключ-АСТРОМ / Эндпойнты среды / АктивныеШлюзы / Конфигурация автообновления / Редактировать АктивныйШлюз

Редактирует конфигурацию автообновления указанной среды АктивногоШлюза.

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

PUT
  • Managed https: // {ваш-домен} / e / {ваш-идентификатор-среды} / api / v2 / activeGates / {agId} / autoUpdate
  • Среда АктивногоШлюза https: // {your-activegate-domain} / e / {your-environment-id} / api / v2 / activeGates / {agId} / autoUpdate

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

Для выполнения этого запроса вам необходимо разрешение Write АктивныхШлюзов( activeGates.write), назначенное вашему токену API. Чтобы узнать, как его получить и использовать, см. Токены и аутентификация .

Параметры

Параметр Тип Описание In необходимость
старение string ID необходимого АктивногоШлюза. path обязательный
body АктивныйШлюз Auto Update Config Тело запроса в формате JSON, содержащее параметры автообновления. body по желанию

Формат тела

  • Параметры запроса

ActiveGateAutoUpdateConfig объект

Настройка автообновлений АктивногоШлюза.

Элемент Тип Описание необходимые
параметр string Состояние автообновления АктивногоШлюза: включено, отключено или унаследовано.

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

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

  • invalid
  • ВКЛЮЧЕНО
  • Унаследованный
обязательный
  • Модель JSON

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

{
  "setting": "INHERITED",
  "effectiveSetting": "ENABLED"
}

Ответ

Коды ответов

Код Описание
204 Успех. Конфигурация автообновления обновлена. У ответа нет тела.
400 Не удалось. Введены неверные данные.

Тело ответа

Успешный запрос не возвращает никакого содержания.

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

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

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

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

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

Для выполнения этого запроса вам необходимо разрешение Write АктивныхШлюзов( activeGates.write), назначенное вашему токену API. Чтобы узнать, как его получить и использовать, см. Токены и аутентификация .

Ответ

Коды ответов

Код Описание
204 Подтверждено. Представленная конфигурация автообновления действительна. У ответа нет тела.
400 Не удалось. Введены неверные данные.

Тело ответа

Успешный запрос не возвращает никакого содержания.