Получение метаданных токена по ID
Этот вызов API перечисляет метаданные токена кластера по идентификатору токена.
Аутентификация
Для выполнения этого запроса вам необходимо разрешение API (ClusterTokenManagement)
, назначенное вашему токену API. Создайте свой токен API с помощью консоли управления кластером (CMC). Чтобы узнать, как его получить и использовать, см. Аутентификация кластера.
Конечная точка
/api/cluster/v2/tokens
Параметры
Параметр | Тип | Описание | В | Обязательно |
---|---|---|---|---|
id | string | Идентификатор требуемого токена. | path | Да |
Ответ
Коды ответа
Код | Тип | Описание |
---|---|---|
200 | TokenMetadata | Успех |
404 | ErrorEnvelope | Не удалось. Запрошенный токен не найден. |
Объекты тела ответа
Объект TokenMetadata
Element | Type | Description |
---|---|---|
id | string | Идентификатор токена. |
name | string | Имя токена. |
userId | string | Владелец токена. |
revoked | boolean | Статус отзыва токена. Отозванные токены отключены. |
created | integer | Время создания в виде временной метки unix в миллисекундах. |
expires | integer | Время истечения срока действия в виде временной метки unix в миллисекундах. |
lastUse | integer | Отметка времени unix в миллисекундах, когда токен использовался в последний раз. |
scopes | string[] | Список областей, назначенных маркеру.
Элемент может содержать эти значения:
|
personalAccessToken | boolean | Токен является токеном личного доступа (true) или токен API (false) .
|
JSON-модель тела ответа
{
"id": "acbed0c4-4ef1-4303-991f-102510a69322",
"name": "myToken",
"userId": "john.smith",
"revoked": true,
"created": 1554076800000,
"expires": 1585976400000,
"lastUse": 1554354000000,
"personalAccessToken": true,
"scopes": [
"DataExport",
"ReadConfig",
"WriteConfig"
]
}
Пример
В этом примере запрос получает метаданные токена с идентификатором 4e9f128e-04f9-4795-pj319-8b7c-3c14a5e885e4
.
Curl
curl -X GET "https://myManaged.cluster.com/api/cluster/v2/tokens/4e9f128e-04f9-4795-pj319-8b7c-3c14a5e885e4" -H "accept: application/json; charset=utf-8"
URL-адрес запроса
https://myManaged.cluster.com/api/cluster/v2/tokens/4e9f128e-04f9-4795-pj319-8b7c-3c14a5e885e4
Тело ответа
{
"id": "4e9f128e-04f9-4795-pj319-8b7c-3c14a5e885e4",
"name": "myToken",
"userId": "john.smith",
"revoked": true,
"created": 1554076800000,
"expires": 1585976400000,
"lastUse": 1554354000000,
"scopes": [
"DataExport",
"ReadConfig",
"WriteConfig"
]
}
Код ответа
204