Получить конкретное задание автообновления

Получает параметры указанного задания автоматического обновления ActiveGate.

Запрос создает application/jsonполезную нагрузку.

ПОЛУЧИТЬ	Удалось	https://{your-domain}/e/{your-environment-id}/api/v2/activeGates/{agId}/updateJobs/{jobId}
	SaaS	https://{your-environment-id}.live.dynatrace.com/api/v2/activeGates/{agId}/updateJobs/{jobId}
	Среда ActiveGate	https://{your-activegate-domain}/e/{your-environment-id}/api/v2/activeGates/{agId}/updateJobs/{jobId}

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

Чтобы выполнить этот запрос, вам необходимо разрешение на чтение ActiveGates ( activeGates.read), назначенное вашему токену API. Чтобы узнать, как его получить и использовать, см. Токены и аутентификация .

Параметры

Параметр	Тип	Описание	В	необходимые
стареть	нить	ID необходимого ActiveGate.	дорожка	по желанию
jobId	нить	Уникальный идентификатор задания обновления ActiveGate.	дорожка	по желанию

Ответ

Коды ответов

Код	Тип	Описание
200	Обновить задание	Успех
404	Конверт ошибки	Не найден. См. Подробности в теле ответа.

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

объект UpdateJob

Конфигурация задания обновления ActiveGate.

Элемент	Тип	Описание	необходимые
jobState	нить	Статус задания обновления. Элемент может содержать эти значения FAILED IN_PROGRESS PENDING ROLLBACK SCHEDULED SKIPPED SUCCEED	по желанию
updateMethod	нить	Метод обновления ActiveGate или его компонента. Элемент может содержать эти значения AUTOMATIC MANUAL_INSTALLATION ON_DEMAND	по желанию
updateType	нить	Компонент, который нужно обновить. Элемент может содержать эти значения ACTIVE_GATE REMOTE_PLUGIN_AGENT SYNTHETIC Z_REMOTE	по желанию
agType	нить	Тип ActiveGate. Элемент может содержать эти значения CLUSTER ENVIRONMENT ENVIRONMENT_MULTI	по желанию
startVersion	нить	Первоначальная версия ActiveGate.	по желанию
окружающая среда	строка []	Список сред (заданных идентификаторами), к которым ActiveGate может подключиться.	по желанию
отменяемый	логический	В настоящий момент задание можно ( true) или нельзя ( false) отменить.	по желанию
jobId	нить	Идентификатор задания обновления.	по желанию
отметка времени	целое число	Отметка времени завершения задания обновления. nullЗначение означает , что работа по - прежнему работает.	по желанию
продолжительность	целое число	Продолжительность обновления в миллисекундах.	по желанию
targetVersion	нить	Целевая версия обновления. Укажите версию в <major>.<minor>.<revision>.<timestamp>формате. Чтобы обновить до последней доступной версии, используйте latestзначение.	обязательный
ошибка	нить	Информация об ошибке обновления.	по желанию

Модель JSON тела ответа

{
  "jobState": "SUCCEED",
  "updateMethod": "AUTOMATIC",
  "updateType": "ACTIVE_GATE",
  "agType": "ENVIRONMENT",
  "startVersion": "1.185.0.20200201-120000",
  "environments": [
    "string"
  ],
  "cancelable": false,
  "jobId": "-3524498778810258605",
  "timestamp": 1582031917814,
  "duration": 3608000,
  "targetVersion": "1.190.0.20200301-130000",
  "error": "string"
}

Пример

В этом примере запрос перечисляет параметры задания автоматического обновления с идентификатором -7537034309286328684 от ActiveGate с идентификатором 2131628184 .

Токен API передается в заголовке авторизации .

Завиток

curl -L -X GET 'https://mySampleEnv.live.dynatrace.com/api/v2/activeGates/2131628184/updateJobs/-7537034309286328684' \
-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'

URL запроса

https://mySampleEnv.live.dynatrace.com/api/v2/activeGates/2131628184/updateJobs/-7537034309286328684

Тело ответа

{
  "jobId": "-7537034309286328684",
  "jobState": "SUCCEED",
  "updateMethod": "AUTOMATIC",
  "updateType": "SYNTHETIC",
  "cancelable": false,
  "startVersion": "1.198.0.20200629-183024",
  "targetVersion": "1.198.0.20200630-114457",
  "timestamp": 1593518788274,
  "agType": "ENVIRONMENT",
  "environments": [
    "mySampleEnv"
  ],
  "error": null,
  "duration": 596047
}

Код ответа

200