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

Материал из Dynatrace
 
(не показана 1 промежуточная версия этого же участника)
Строка 1: Строка 1:
Завершает ротацию токена владельца. Старый токен становится недействительным. Выполняйте запрос только после обновления всех ЕдиныхАгентов и АктивныхШлюзов, как описано в разделе « Ротация токена владельца » .
Завершает ротацию токена владельца. Старый токен становится недействительным. Выполняйте запрос только после обновления всех OneAgents и ActiveGates, как описано в разделе « Ротация токена владельца » .


Во избежание потери данных в процессе ротации действуют как старые, так и новые токены. Во время ротации не развертывайте никаких новых ЕдиныхАгентов, пока все ваши АктивныхШлюзов не будут настроены с использованием нового токена владельца.
Во избежание потери данных в процессе ротации действуют как старые, так и новые токены. Во время ротации не развертывайте никаких новых OneAgents, пока все ваши ActiveGates не будут настроены с использованием нового токена владельца.


Запрос создает в качестве полезной нагрузки<code>application/json</code> формат.
Запрос создает в качестве полезной нагрузки<code>application/json</code> формат.
Строка 9: Строка 9:
|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/v2/tenantTokenRotation/finish</nowiki></code>
|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/v2/tenantTokenRotation/finish</nowiki></code>
|-
|-
|Среда АктивногоШлюза
|Среда ActiveGate
|<code><nowiki>https://{your-activegate-domain}/e/{your-environment-id}/api/v2/tenantTokenRotation/finish</nowiki></code>
|<code><nowiki>https://{your-activegate-domain}/e/{your-environment-id}/api/v2/tenantTokenRotation/finish</nowiki></code>
|}
|}
Строка 83: Строка 83:
==== Curl ====
==== Curl ====
  <code>curl -X POST \
  <code>curl -X POST \
   <nowiki>https://mySampleEnv.live.ruscomtech.ru/api/v2/tenantTokenRotation/finish</nowiki> \
   <nowiki>https://mySampleEnv.live.dynatrace.com/api/v2/tenantTokenRotation/finish</nowiki> \
   -H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890' \
   -H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890' \
   -H 'Accept: application/json'</code>
   -H 'Accept: application/json'</code>

Текущая версия на 17:19, 13 февраля 2023

Завершает ротацию токена владельца. Старый токен становится недействительным. Выполняйте запрос только после обновления всех OneAgents и ActiveGates, как описано в разделе « Ротация токена владельца » .

Во избежание потери данных в процессе ротации действуют как старые, так и новые токены. Во время ротации не развертывайте никаких новых OneAgents, пока все ваши ActiveGates не будут настроены с использованием нового токена владельца.

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

POST Managed https://{your-domain}/e/{your-environment-id}/api/v2/tenantTokenRotation/finish
Среда ActiveGate https://{your-activegate-domain}/e/{your-environment-id}/api/v2/tenantTokenRotation/finish

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

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

Параметры

Запрос не предоставляет никаких настраиваемых параметров.

Ответ

Коды ответов

Код Тип Описание
200 TenantTokenConfig Успех. Процесс вращения завершен. Активное поле ответа содержит новый токен арендатора.
400 ErrorEnvelope Нет постоянного процесса ротации.

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

Объект TenantTokenConfig

Конфигурация токена арендатора .

Элемент Тип Описание
old TenantToken Токен владельца
active TenantToken Токен владельца

Объект TenantToken

Токен арендатора

Элемент Тип Описание
value string Секрет токена арендатора.

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

{
  "old": {
    "value": "string"
  },
  "active": {}
}

Пример

В этом примере запрос завершает процесс ротации, начатый в примере запуска запроса .

Код ответа 200 указывает на успешный запрос. Старый токен 1234567890qrstuvwxyz больше недействителен.

Маркер API передается в заголовке авторизации .

Curl

curl -X POST \
  https://mySampleEnv.live.dynatrace.com/api/v2/tenantTokenRotation/finish \
  -H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890' \
  -H 'Accept: application/json'

Тело ответа

{
  "active": {
    "value": "zyxwvutsrq0987654321"
  },
  "old": {
    "value": "1234567890qrstuvwxyz"
  }
}

Код ответа

200