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

Материал из Dynatrace
Версия от 11:41, 22 января 2023; Lobanov (обсуждение | вклад)
(разн.) ← Предыдущая | Текущая версия (разн.) | Следующая → (разн.)

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

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

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

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

Аутентификация

Для выполнения этого запроса вам необходимо разрешение API (ClusterTokenManagement), назначенное вашему токену API. Создайте свой токен API с помощью консоли управления кластером (CMC). Чтобы узнать, как его получить и использовать, см. Аутентификация кластера.

Конечная точка

/api/cluster/v2/tokens

Параметры

Параметр Тип Описание В Обязательно
limit integer Ограничивает максимальное количество возвращаемых токенов.

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

Максимальное значение — 1000000.

query Нет
user string Фильтрует результирующий набор токенов по пользователю, которому принадлежит токен. query Нет
permissions string[] Фильтрует результирующий набор токенов по областям, назначенным токену.

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

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

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

  • ClusterTokenManagement
  • ControlManagement
  • DiagnosticExport
  • EnvironmentTokenManagement
  • ExternalSyntheticIntegration
  • Nodekeeper
  • ReadSyntheticData
  • ServiceProviderAPI
  • UnattendedInstall
  • activeGateTokenManagement.create
  • activeGateTokenManagement.read
  • activeGateTokenManagement.write
  • apiTokens.read
  • apiTokens.write
  • settings.read
  • settings.write
query Нет
from integer Последнее использование после этой метки времени (миллисекунды UTC). query Нет
to integer Последнее использование перед этой отметкой времени (миллисекунды UTC). query Нет

Ответ

Коды ответа

Код Тип Описание
200 StubList Успешно

Объекты тела ответа

Объект StubList

Элемент Тип Описание
values EntityShortRepresentation[] Упорядоченный список кратких представлений объектов Ключ-Астром.
name string Имя объекта.
description string Краткое описание сущности.
tokenManagementToken string Токен с разрешением «Управление токенами». Может использоваться во вновь созданной среде для создания других токенов для настройки этой среды. Это значение задается только в том случае, если среда была создана с параметром запроса createToken=true.

Объект EntityShortRepresentation

Элемент Тип Описание
id string Идентификатор объекта.
name string Имя объекта.
description string Краткое описание объекта.

JSON-модель тела ответа

{
  "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"
    }
  ]
}

Пример

В этом примере в запросе перечислены токены API в среде myManaged.cluster.com для пользователя Pete с разрешениями на управление токенами кластера.

Curl

curl -X GET "https://myManaged.cluster.com/api/cluster/v2/tokens?limit=1000&user=Pete&permissions=ClusterTokenManagement" -H  "accept: application/json; charset=utf-8"

URL-адрес запроса

https://myManaged.cluster.com/api/cluster/v2/tokens?limit=1000

Тело ответа

{
  "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"
    }
  ]
}

Код ответа

200