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 контролируется областью, а это означает, что вам также нужны соответствующие разрешения, назначенные токену. Проделайте шаги ниже, чтобы узнать, какие разрешения необходимы для его использования.
- Зарегистрируйте клиента (Создание клиентского SSO).
- Сгенерируйте токен (Создание SSO-токена). В настоящее время поддерживается только область
sso20-managed-cluster-offline-bundle
, которая позволяет создавать URL-адреса для скачивания пакетов обновлений. - Выполняйте аутентификацию в вызовах 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
— Слишком много запросов. Контроллер Задач сейчас занят, повторите попытку позже.