POST старт ротации: различия между версиями
ENetrebin (обсуждение | вклад) (Новая страница: «Инициирует ротацию токена клиента. Запрос создает новый токен владельца, который необхо...») |
ENetrebin (обсуждение | вклад) |
||
| (не показана 1 промежуточная версия этого же участника) | |||
| Строка 1: | Строка 1: | ||
Инициирует ротацию токена клиента. Запрос создает новый токен владельца, который необходимо добавить в конфигурацию ваших | Инициирует ротацию токена клиента. Запрос создает новый токен владельца, который необходимо добавить в конфигурацию ваших OneAgents и ActiveGates. Полное описание процесса ротации см . в разделе Ротация маркера клиента . | ||
Во избежание потери данных в процессе ротации действуют как старые, так и новые токены. Во время ротации не развертывайте никаких новых | Во избежание потери данных в процессе ротации действуют как старые, так и новые токены. Во время ротации не развертывайте никаких новых OneAgents, пока все ваши ActiveGates не будут настроены с использованием нового токена арендатора. | ||
Запрос создает <code>application/json</code> | Запрос создает в качестве полезной нагрузки <code>application/json</code> формат. | ||
{| class="wikitable" | {| class="wikitable" | ||
| rowspan="2" |POST | | rowspan="2" |POST | ||
| Строка 9: | Строка 9: | ||
|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/v2/tenantTokenRotation/start</nowiki></code> | |<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/v2/tenantTokenRotation/start</nowiki></code> | ||
|- | |- | ||
|Среда | |Среда ActiveGate | ||
|<code><nowiki>https://{your-activegate-domain}/e/{your-environment-id}/api/v2/tenantTokenRotation/start</nowiki></code> | |<code><nowiki>https://{your-activegate-domain}/e/{your-environment-id}/api/v2/tenantTokenRotation/start</nowiki></code> | ||
|} | |} | ||
| Строка 38: | Строка 38: | ||
=== Объекты тела ответа === | === Объекты тела ответа === | ||
==== Объект | ==== Объект <code>TenantTokenConfig</code> ==== | ||
Конфигурация токена арендатора . | Конфигурация токена арендатора . | ||
{| class="wikitable" | {| class="wikitable" | ||
| Строка 83: | Строка 83: | ||
==== Curl ==== | ==== Curl ==== | ||
<code>curl -X POST \ | <code>curl -X POST \ | ||
https://mySampleEnv.live.dynatrace.com<nowiki/>/api/v2/tenantTokenRotation/start \ | |||
-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:13, 13 февраля 2023
Инициирует ротацию токена клиента. Запрос создает новый токен владельца, который необходимо добавить в конфигурацию ваших OneAgents и ActiveGates. Полное описание процесса ротации см . в разделе Ротация маркера клиента .
Во избежание потери данных в процессе ротации действуют как старые, так и новые токены. Во время ротации не развертывайте никаких новых OneAgents, пока все ваши ActiveGates не будут настроены с использованием нового токена арендатора.
Запрос создает в качестве полезной нагрузки application/json формат.
| POST | Managed | https://{your-domain}/e/{your-environment-id}/api/v2/tenantTokenRotation/start
|
| Среда ActiveGate | https://{your-activegate-domain}/e/{your-environment-id}/api/v2/tenantTokenRotation/start
|
Аутентификация
Чтобы выполнить этот запрос, вам нужен токен доступа с областью ротации токенов владельца ( tenantTokenRotation.write) . Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация .
Параметры
Запрос не предоставляет никаких настраиваемых параметров.
Ответ
Коды ответов
| Код | Тип | Описание |
|---|---|---|
| 200 | TenantTokenConfig | Успех. Создан новый токен арендатора, который заменит старый. Активное поле ответа содержит новый токен владельца. |
| 400 | ErrorEnvelope | Не удалось. Другой процесс ротации уже идет. |
Объекты тела ответа
Объект TenantTokenConfig
Конфигурация токена арендатора .
| Элемент | Тип | Описание |
|---|---|---|
| old | TenantToken | Токен владельца |
| active | TenantToken | Токен владельца |
Объект TenantToken
Токен владельца
| Элемент | Тип | Описание |
|---|---|---|
| value | string | Секрет токена владельца. |
JSON-модель тела ответа
{
"old": {
"value": "string"
},
"active": {}
}
Пример
В этом примере запрос запускает процесс ротации для среды mySampleEnv .
Код ответа 200 указывает на успешный запрос. Новый сгенерированный токен — zyxwvutsrq0987654321 .
Маркер API передается в заголовке авторизации .
Curl
curl -X POST \
https://mySampleEnv.live.dynatrace.com/api/v2/tenantTokenRotation/start \
-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890' \
-H 'Accept: application/json'
Тело ответа
{
"active": {
"value": "zyxwvutsrq0987654321"
},
"old": {
"value": "1234567890qrstuvwxyz"
}
}
Код ответа
200
