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

Материал из Dynatrace
(Новая страница: «Чтобы пройти аутентификацию для использования API Контроллера Задач, вам необходим дейст...»)
 
 
(не показана 1 промежуточная версия этого же участника)
Строка 3: Строка 3:
# Зарегистрируйте клиента ([[Создание клиентского SSO]]).
# Зарегистрируйте клиента ([[Создание клиентского SSO]]).
# Сгенерируйте токен ([[Создание SSO-токена]]). В настоящее время поддерживается только область <code>sso20-managed-cluster-offline-bundle</code>, которая позволяет создавать URL-адреса для скачивания пакетов обновлений.
# Сгенерируйте токен ([[Создание 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> — Слишком много запросов. Контроллер Задач сейчас занят, повторите попытку позже.
 
== Создание 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

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