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

Версия от 17:50, 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 — Слишком много запросов. Контроллер Задач сейчас занят, повторите попытку позже.

@@ Строка 3: / Строка 3: @@
 # Зарегистрируйте клиента ([[Создание клиентского SSO]]).
 # Сгенерируйте токен ([[Создание SSO-токена]]). В настоящее время поддерживается только область <code>sso20-managed-cluster-offline-bundle</code>, которая позволяет создавать URL-адреса для скачивания пакетов обновлений.
-# Выполняйте аутентификацию в вызовах API. Присоедините токен к заголовку HTTP авторизации, предшествующему области Bearer.
+# Выполняйте аутентификацию в вызовах API. Присоедините токен к заголовку HTTP авторизации, предшествующему области <code>Bearer</code>.
+Пример аутентификации:
+ <code>curl -X GET "<nowiki>https://mcsvc.dynatrace.com/rest/public/downloads/offline-bundle/published</nowiki>"
+ -H "accept: application/json"
+ -H "Authorization: Bearer aaA0aAAaAaAAA0AaAAAaaAaaAaAAAaA0AaA0.eyJzdWIiOiJjbHVzdGVyLTBhMDBhMGEwLTkyZWMtMTFlNy1iMWU2LTEyZmJkMWZiMzczMkBkeW5hdHJhY2UtbWFuYWdlZC5jb20iLCJhdWQiOiJkdDBzMDQuTFFWT1FQQVMiLCJ1aWQiOiI5N2Y0OGFhMy1jYmRiLTRkMzEtOGE2YS02NjUyNTQxMzY5MTIiLCJzY29wZSI6InNzbzIwLW1hbmFnZWQtY2x1c3Rlci1vZmZsaW5lLWJ1bmRsZSIsImlzcyI6Imh0dHBzOi8vc3NvLXNwcmludC5keW5hdHJhY2VsYWJzLmNvbTo0NDMiLCJleHAiOjE2MTU0NzcxNTIsImdyYW50VHlwZSI6ImNsaWVudF9jcmVkZW50aWFscyIsImlhdCI6MTYxNTQ2OTk1Mn0.svn34bJEZbziHVyV7cKW9OWwvBwakzH0Ke_Iu19GV743zrC4zHuX4YQFts-JkEHRYmnVvnQRwPPCakuq0LHVjA"</code>
+Если не указано иное, используются следующие коды ответа:
+* <code>200</code> — Запрос выполнен успешно.
+* <code>400</code> — Некорректный запрос. Запрос не выполнен. В тексте ответа содержатся дополнительные сведения.
+* <code>401</code> — Ошибка доступа. Аутентификация токена не удалась. Проверьте, есть ли у вашего токена необходимые разрешения.
+* <code>404</code> — Не найдено. Запрашиваемый ресурс не найден. Проверьте правильность вашего ввода.
+* <code>429</code> — Слишком много запросов. Контроллер Задач сейчас занят, повторите попытку позже.
+== Офлайн-пакеты ==
+* [[Получить список доступных пакетов и обновлений]]
+* [[Получить офлайн-пакет]]