Завершает ротацию токена владельца. Старый токен становится недействительным. Выполняйте запрос только после обновления всех ЕдиныхАгентов и АктивныхШлюзов, как описано в разделе « Ротация токена владельца » .
Во избежание потери данных в процессе ротации действуют как старые, так и новые токены. Во время ротации не развертывайте никаких новых ЕдиныхАгентов, пока все ваши АктивныхШлюзов не будут настроены с использованием нового токена владельца.
Запрос создает в качестве полезной нагрузкиapplication/json
формат.
POST | АппОптима | https://{your-domain}/e/{your-environment-id}/api/v2/tenantTokenRotation/finish
|
Среда АктивногоШлюза | 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.ruscomtech.ru/api/v2/tenantTokenRotation/finish \ -H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890' \ -H 'Accept: application/json'
Тело ответа
<{ "active": { "value": "zyxwvutsrq0987654321" }, "old": { "value": "1234567890qrstuvwxyz" } }
Код ответа
200