Создание нового токена
Этот вызов API создает новый токен кластера.
Аутентификация
Для выполнения этого запроса вам необходимо разрешение API (ServiceProviderAPI)
, назначенное вашему токену API. Создайте свой токен API с помощью консоли управления кластером (CMC). Чтобы узнать, как его получить и использовать, см. Аутентификация кластера.
Конечная точка
/api/cluster/v2/tokens
Параметры
Параметр | Тип | Описание | В | Обязательно |
---|---|---|---|---|
body | CreateToken | Тело JSON запроса. Содержит параметры нового токена. | body | Да |
Объекты тела запроса
Объект CreateToken
Элемент | Тип | Описание | Обязательно |
---|---|---|---|
name | string | Имя токена. | Да |
expiresIn | Duration | Defines a period of time. | Нет |
scopes | string[] | Список областей, которые должны быть назначены токену.
|
Нет |
Объект Duration
Элемент | Тип | Описание | Обязательно |
---|---|---|---|
value | integer | Количество времени. | Да |
unit | string | Единица времени.
Если не установлено, используется миллисекунда. Элемент может содержать эти значения:
|
Нет |
JSON-модель тела запроса
{
"name": "string",
"expiresIn": {
"value": 1,
"unit": "DAYS"
},
"scopes": [
"DiagnosticExport"
]
}
Ответ
Коды ответа
Код | Тип | Описание |
---|---|---|
201 | Token | Успех. Токен создан. Тело ответа содержит сам токен. |
400 | ErrorEnvelope | Не удалось. Ввод недействителен. Тело ответа содержит подробные сведения. |
Объекты тела ответа
Объект Token
Element | Type | Description |
---|---|---|
token | string | Токен аутентификации API. |
JSON-модель тела ответа
{
"token": "abcdefjhij1234567890"
}
Пример
В этом примере запрос создает новый токен с именем Mytoken
, действительный в течение 24 часов. С помощью этого токена вы сможете выполнять диагностический экспорт (DiagnosticExport)
и автоматическую установку (UnattendedInstall)
.
Curl
curl -X POST "https://myManaged.cluster.com/api/cluster/v2/tokens" -H "accept: application/json; charset=utf-8" -H "Content-Type: application/json; charset=utf-8" -d "{ \"name\": \"MyToken\", \"scopes\": [ \"DiagnosticExport\", \"UnattendedInstall\" ], \"expiresIn\": { \"value\": 24, \"unit\": \"HOURS\" }}"
URL-адрес запроса
https://myManaged.cluster.com/api/cluster/v2/tokens
Тело запроса
{
"name": "MyToken",
"scopes": ["DiagnosticExport", "UnattendedInstall"],
"expiresIn": {
"value": 24,
"unit": "HOURS"
}
}
Тело ответа
{
"token": "abcdefjhij1234567890"
}
Код ответа
201