API Контроллера Задач: различия между версиями

Материал из Dynatrace
 
Строка 15: Строка 15:
* <code>404</code> — Не найдено. Запрашиваемый ресурс не найден. Проверьте правильность вашего ввода.
* <code>404</code> — Не найдено. Запрашиваемый ресурс не найден. Проверьте правильность вашего ввода.
* <code>429</code> — Слишком много запросов. Контроллер Задач сейчас занят, повторите попытку позже.
* <code>429</code> — Слишком много запросов. Контроллер Задач сейчас занят, повторите попытку позже.
== Создание SSO ==
* [[Создание клиентского SSO]]
* [[Создание SSO-токена]]


== Офлайн-пакеты ==
== Офлайн-пакеты ==

Текущая версия на 17:51, 22 сентября 2022

Чтобы пройти аутентификацию для использования API Контроллера Задач, вам необходим действительный клиентский токен OAuth REST API. Доступ к API контролируется областью, а это означает, что вам также нужны соответствующие разрешения, назначенные токену. Проделайте шаги ниже, чтобы узнать, какие разрешения необходимы для его использования.

  1. Зарегистрируйте клиента (Создание клиентского SSO).
  2. Сгенерируйте токен (Создание SSO-токена). В настоящее время поддерживается только область sso20-managed-cluster-offline-bundle, которая позволяет создавать URL-адреса для скачивания пакетов обновлений.
  3. Выполняйте аутентификацию в вызовах API. Присоедините токен к заголовку HTTP авторизации, предшествующему области Bearer.

Пример аутентификации:

curl -X GET "https://mcsvc.dynatrace.com/rest/public/downloads/offline-bundle/published"
-H "accept: application/json"
-H "Authorization: Bearer aaA0aAAaAaAAA0AaAAAaaAaaAaAAAaA0AaA0.eyJzdWIiOiJjbHVzdGVyLTBhMDBhMGEwLTkyZWMtMTFlNy1iMWU2LTEyZmJkMWZiMzczMkBkeW5hdHJhY2UtbWFuYWdlZC5jb20iLCJhdWQiOiJkdDBzMDQuTFFWT1FQQVMiLCJ1aWQiOiI5N2Y0OGFhMy1jYmRiLTRkMzEtOGE2YS02NjUyNTQxMzY5MTIiLCJzY29wZSI6InNzbzIwLW1hbmFnZWQtY2x1c3Rlci1vZmZsaW5lLWJ1bmRsZSIsImlzcyI6Imh0dHBzOi8vc3NvLXNwcmludC5keW5hdHJhY2VsYWJzLmNvbTo0NDMiLCJleHAiOjE2MTU0NzcxNTIsImdyYW50VHlwZSI6ImNsaWVudF9jcmVkZW50aWFscyIsImlhdCI6MTYxNTQ2OTk1Mn0.svn34bJEZbziHVyV7cKW9OWwvBwakzH0Ke_Iu19GV743zrC4zHuX4YQFts-JkEHRYmnVvnQRwPPCakuq0LHVjA"

Если не указано иное, используются следующие коды ответа:

  • 200 — Запрос выполнен успешно.
  • 400 — Некорректный запрос. Запрос не выполнен. В тексте ответа содержатся дополнительные сведения.
  • 401 — Ошибка доступа. Аутентификация токена не удалась. Проверьте, есть ли у вашего токена необходимые разрешения.
  • 404 — Не найдено. Запрашиваемый ресурс не найден. Проверьте правильность вашего ввода.
  • 429 — Слишком много запросов. Контроллер Задач сейчас занят, повторите попытку позже.

Создание SSO

Офлайн-пакеты