Просмотр кода страницы Получение списка доступных токенов

Этот вызов API перечисляет доступные маркеры в вашей среде. 

Вы можете сузить вывод, добавив параметры. Токен должен соответствовать всем указанным параметрам. 

Вы также можете указать лимит возвращаемых токенов. 

Этот список может содержать токены, которые были созданы автоматически (например, InstallerDownload, Mobile, …) и не отображаются на странице настроек. Их удаление может иметь непреднамеренные побочные эффекты, поскольку они все еще могут использоваться.

==Аутентификация==
Для выполнения этого запроса вам необходимо разрешение API <code>(ClusterTokenManagement)</code>, назначенное вашему токену API. Создайте свой токен API с помощью консоли управления кластером (CMC). Чтобы узнать, как его получить и использовать, см. [https://doc.ruscomtech.ru/index.php/%D0%90%D1%83%D1%82%D0%B5%D0%BD%D1%82%D0%B8%D1%84%D0%B8%D0%BA%D0%B0%D1%86%D0%B8%D1%8F_%D0%BA%D0%BB%D0%B0%D1%81%D1%82%D0%B5%D1%80%D0%B0 Аутентификация кластера].
==Конечная точка==
<code>/api/cluster/v2/tokens</code>
==Параметры==
{| class="wikitable"
!Параметр
!Тип
!Описание
!В
!Обязательно
|-
|limit
|integer
|Ограничивает максимальное количество возвращаемых токенов. 

Если не установлено, используется значение <code>1000</code>. 

Максимальное значение — <code>1000000</code>.
|query
|Нет
|-
|user
|string
|Фильтрует результирующий набор токенов по пользователю, которому принадлежит токен.
|query
|Нет
|-
|permissions
|string[]
|Фильтрует результирующий набор токенов по областям, назначенным токену. 

Вы можете указать несколько разрешений в следующем формате: <code>permissions=scope1&permissions=scope2</code>. 

Токен должен иметь ''все'' указанные области. 

Элемент может содержать эти значения:

* <code>ClusterTokenManagement</code>
* <code>ControlManagement</code>
* <code>DiagnosticExport</code>
* <code>EnvironmentTokenManagement</code>
* <code>ExternalSyntheticIntegration</code>
* <code>Nodekeeper</code>
* <code>ReadSyntheticData</code>
* <code>ServiceProviderAPI</code>
* <code>UnattendedInstall</code>
* <code>activeGateTokenManagement.create</code>
* <code>activeGateTokenManagement.read</code>
* <code>activeGateTokenManagement.write</code>
* <code>apiTokens.read</code>
* <code>apiTokens.write</code>
* <code>settings.read</code>
* <code>settings.write</code>
|query
|Нет
|-
|from
|integer
|Последнее использование после этой метки времени (миллисекунды UTC).
|query
|Нет
|-
|to
|integer
|Последнее использование перед этой отметкой времени (миллисекунды UTC).
|query
|Нет
|}
==Ответ==
===Коды ответа===
{| class="wikitable"
!Код
!Тип
!Описание
|-
|'''200'''
|StubList
|Успешно
|}
===Объекты тела ответа===
====Объект <code>StubList</code>====
{| class="wikitable"
!Элемент
!Тип
!Описание
|-
|values
|EntityShortRepresentation[]
|Упорядоченный список кратких представлений объектов Ключ-Астром.
|-
|name
|string
|Имя объекта.
|-
|description
|string
|Краткое описание сущности.
|-
|tokenManagementToken
|string
|Токен с разрешением «Управление токенами». Может использоваться во вновь созданной среде для создания других токенов для настройки этой среды. Это значение задается только в том случае, если среда была создана с параметром запроса createToken=true.
|}
====Объект <code>EntityShortRepresentation</code>====
{| class="wikitable"
!Элемент
!Тип
!Описание
|-
|id
|string
|Идентификатор объекта.
|-
|name
|string
|Имя объекта.
|-
|description
|string
|Краткое описание объекта.
|}
===JSON-модель тела ответа===
 <code>{
   "values": [
     {
       "id": "6a98d7bc-abb9-44f8-ae6a-73e68e71812a",
       "name": "Dynatrace entity 1",
       "description": "Dynatrace entity 1 for the REST API example"
     },
     {
       "id": "ee70f7d3-9a4e-4f5f-94d2-c9d6156f1618",
       "name": "Dynatrace entity 2"
     },
     {
       "id": "8cdabe77-9e1a-4be8-b3df-269dd6fa9d7f"
     }
   ]
 }</code>
==Пример==
В этом примере в запросе перечислены токены API в среде <code>myManaged.cluster.com</code> для пользователя <code>Pete</code> с разрешениями на управление токенами кластера.
====Curl====
<code>curl -X GET "<nowiki>https://myManaged.cluster.com/api/cluster/v2/tokens?limit=1000&user=Pete&permissions=ClusterTokenManagement</nowiki>" -H  "accept: application/json; charset=utf-8"</code>
====URL-адрес запроса====
<code><nowiki>https://myManaged.cluster.com/api/cluster/v2/tokens?limit=1000</nowiki></code>

====Тело ответа====
 <code>{
   "values": [
     {
       "id": "6a98d7bc-abb9-44f8-ae6a-73e68e71812a",
       "name": "Dynatrace entity 1",
       "description": "Dynatrace entity 1 for the REST API example"
     },
     {
       "id": "ee70f7d3-9a4e-4f5f-94d2-c9d6156f1618",
       "name": "Dynatrace entity 2"
     },
     {
       "id": "8cdabe77-9e1a-4be8-b3df-269dd6fa9d7f"
     }
   ]
 }</code>
====Код ответа====
<code>200</code>