Получение АктивныхШлюзов с автообновлением заданий - История изменений

ENetrebin в 07:01, 21 февраля 2022

2022-02-21T07:01:04Z

← Предыдущая		Версия 07:01, 21 февраля 2022
Строка 1:		Строка 1:
	Список всех ~~ActiveGate~~, у которых есть задания автоматического обновления. В список входят выполненные задания (успешные или неуспешные) и выполняемые задания.		Список всех АктивныхШлюзов, у которых есть задания автоматического обновления. В список входят выполненные задания (успешные или неуспешные) и выполняемые задания.

	Вы можете сузить вывод, указав параметры фильтрации в своем запросе.		Вы можете сузить вывод, указав параметры фильтрации в своем запросе.
Строка 12:		Строка 12:
	\|<code><nowiki>https://{your-environment-id}.live.dynatrace.com/api/v2/activeGates/updateJobs</nowiki></code>		\|<code><nowiki>https://{your-environment-id}.live.dynatrace.com/api/v2/activeGates/updateJobs</nowiki></code>
	\|-		\|-
	\|Окружающая среда ~~ActiveGate~~		\|Окружающая среда АктивногоШлюза
	\|<code><nowiki>https://{your-activegate-domain}/e/{your-environment-id}/api/v2/activeGates/updateJobs</nowiki></code>		\|<code><nowiki>https://{your-activegate-domain}/e/{your-environment-id}/api/v2/activeGates/updateJobs</nowiki></code>
	\|}		\|}

	== Аутентификация ==		== Аутентификация ==
	Для выполнения этого запроса вам необходимо разрешение Read ~~ActiveGates~~ ( <code>activeGates.read</code>) , назначенное вашему токену API. Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация .		Для выполнения этого запроса вам необходимо разрешение Read АктивныхШлюзов ( <code>activeGates.read</code>) , назначенное вашему токену API. Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация .

	== Параметры ==		== Параметры ==
Строка 153:		Строка 153:

	==== Объект _ <code>UpdateJobsAll</code> ====		==== Объект _ <code>UpdateJobsAll</code> ====
	Список ~~ActiveGate~~ с заданиями на обновление.		Список АктивныхШлюзов с заданиями на обновление.
	{\| class="wikitable"		{\| class="wikitable"
	!Элемент		!Элемент
Строка 161:		Строка 161:
	\|всеобновитьработы		\|всеобновитьработы
	\|Обновить список заданий []		\|Обновить список заданий []
	\|Список ~~ActiveGate~~ с заданиями на обновление.		\|Список АктивныхШлюзов с заданиями на обновление.

	Может быть <code>null</code>.		Может быть <code>null</code>.
Строка 167:		Строка 167:

	==== Объект _ <code>UpdateJobList</code> ====		==== Объект _ <code>UpdateJobList</code> ====
	Список заданий обновления ~~ActiveGate~~.		Список заданий обновления АктивногоШлюза.
	{\| class="wikitable"		{\| class="wikitable"
	!Элемент		!Элемент
Строка 175:		Строка 175:
	\|agId		\|agId
	\|нить		\|нить
	\|Идентификатор ~~ActiveGate~~.		\|Идентификатор АктивногоШлюза.

	Может быть <code>null</code>.		Может быть <code>null</code>.
Строка 181:		Строка 181:
	\|обновлениеJobs		\|обновлениеJobs
	\|Обновить задание []		\|Обновить задание []
	\|Список заданий обновления ~~ActiveGate~~.		\|Список заданий обновления АктивногоШлюза.

	Может быть <code>null</code>.		Может быть <code>null</code>.
Строка 187:		Строка 187:

	==== Объект _ <code>UpdateJob</code> ====		==== Объект _ <code>UpdateJob</code> ====
	Настройка задания обновления ~~ActiveGate~~.		Настройка задания обновления АктивногоШлюза.
	{\| class="wikitable"		{\| class="wikitable"
	!Элемент		!Элемент
Строка 211:		Строка 211:
	\|метод обновления		\|метод обновления
	\|нить		\|нить
	\|Способ обновления ~~ActiveGate~~ или его компонентов.		\|Способ обновления АктивногоШлюза или его компонентов.

	Элемент может содержать эти значения		Элемент может содержать эти значения
Строка 236:		Строка 236:
	\|agType		\|agType
	\|нить		\|нить
	\|Тип ~~ActiveGate~~.		\|Тип АктивногоШлюза.

	Элемент может содержать эти значения		Элемент может содержать эти значения
Строка 248:		Строка 248:
	\|стартовая версия		\|стартовая версия
	\|нить		\|нить
	\|Начальная версия ~~ActiveGate~~.		\|Начальная версия АктивногоШлюза.

	Может быть <code>null</code>.		Может быть <code>null</code>.
Строка 254:		Строка 254:
	\|среды		\|среды
	\|строка []		\|строка []
	\|Список сред (определяемых идентификаторами), к которым может подключаться ~~ActiveGate~~.		\|Список сред (определяемых идентификаторами), к которым может подключаться АктивныйШлюз.

	Может быть <code>null</code>.		Может быть <code>null</code>.

ENetrebin: Новая страница: «Список всех ActiveGate, у которых есть задания автоматического обновления. В список входят вы...»

2022-02-21T06:43:52Z

Новая страница: «Список всех ActiveGate, у которых есть задания автоматического обновления. В список входят вы...»

Новая страница

Список всех ActiveGate, у которых есть задания автоматического обновления. В список входят выполненные задания (успешные или неуспешные) и выполняемые задания.

Вы можете сузить вывод, указав параметры фильтрации в своем запросе.

Запрос создает <code>application/json</code>полезную нагрузку.
{| class="wikitable"
| rowspan="3" |ПОЛУЧАТЬ
|Удалось
|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/v2/activeGates/updateJobs</nowiki></code>
|-
|SaaS
|<code><nowiki>https://{your-environment-id}.live.dynatrace.com/api/v2/activeGates/updateJobs</nowiki></code>
|-
|Окружающая среда ActiveGate
|<code><nowiki>https://{your-activegate-domain}/e/{your-environment-id}/api/v2/activeGates/updateJobs</nowiki></code>
|}

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

== Параметры ==
{| class="wikitable"
!Параметр
!Тип
!Описание
!В
!Необходимый
|-
|от
|нить
|Начало запрошенного периода времени для заданий обновления.

Вы можете использовать один из следующих форматов:

* Отметка времени в миллисекундах UTC.
* Человекочитаемый формат <code>2021-01-25T05:57:01.123+01:00</code>. Если часовой пояс не указан, используется UTC. Вы можете использовать пробел вместо <code>T</code>. Секунды и доли секунды не являются обязательными.
* Относительный таймфрейм, назад. Формат: <code>now-NU/A</code>, где <code>N</code>количество времени, <code>U</code>единица времени и <code>A</code>выравнивание. Выравнивание округляет все меньшие значения до ближайшего нуля в прошлом. Например, <code>now-1y/w</code>это один год назад, выровненный на неделю. Вы также можете указать относительный таймфрейм без выравнивания: <code>now-NU</code>. Поддерживаемые единицы времени для относительного таймфрейма:
** <code>m</code>: минут
** <code>h</code>: часы
** <code>d</code>: дней
** <code>w</code>: недели
** <code>M</code>: месяцы
** <code>y</code>: годы

Если не задано, используется относительный таймфрейм в один день ( <code>now-1d</code>).

Максимальный срок 31 день.
|запрос
|необязательный
|-
|к
|нить
|Конец запрошенного периода времени для заданий обновления.

Вы можете использовать один из следующих форматов:

* Отметка времени в миллисекундах UTC.
* Человекочитаемый формат <code>2021-01-25T05:57:01.123+01:00</code>. Если часовой пояс не указан, используется UTC. Вы можете использовать пробел вместо <code>T</code>. Секунды и доли секунды не являются обязательными.
* Относительный таймфрейм, назад. Формат: <code>now-NU/A</code>, где <code>N</code>количество времени, <code>U</code>единица времени и <code>A</code>выравнивание. Выравнивание округляет все меньшие значения до ближайшего нуля в прошлом. Например, <code>now-1y/w</code>это один год назад, выровненный на неделю. Вы также можете указать относительный таймфрейм без выравнивания: <code>now-NU</code>. Поддерживаемые единицы времени для относительного таймфрейма:
** <code>m</code>: минут
** <code>h</code>: часы
** <code>d</code>: дней
** <code>w</code>: недели
** <code>M</code>: месяцы
** <code>y</code>: годы

Если не установлено, используется текущая метка времени.
|запрос
|необязательный
|-
|startVersionCompareType
|нить
|Фильтрует результирующий набор заданий обновления по указанной исходной версии.

Укажите здесь оператор сравнения.

Элемент может содержать эти значения

* <code>EQUAL</code>
* <code>GREATER</code>
* <code>GREATER_EQUAL</code>
* <code>LOWER</code>
* <code>LOWER_EQUAL</code>
|запрос
|необязательный
|-
|стартовая версия
|нить
|Фильтрует результирующий набор update-jobs по начальной версии (обязательный формат <code><major>.<minor>.<revision></code>).
|запрос
|необязательный
|-
|тип обновления
|нить
|Фильтрует результирующий набор заданий обновления по типу обновления.

Элемент может содержать эти значения

* <code>ACTIVE_GATE</code>
* <code>REMOTE_PLUGIN_AGENT</code>
* <code>SYNTHETIC</code>
* <code>Z_REMOTE</code>
|запрос
|необязательный
|-
|targetVersionCompareType
|нить
|Фильтрует результирующий набор заданий обновления по указанной целевой версии.

Укажите здесь оператор сравнения.

Элемент может содержать эти значения

* <code>EQUAL</code>
* <code>GREATER</code>
* <code>GREATER_EQUAL</code>
* <code>LOWER</code>
* <code>LOWER_EQUAL</code>
|запрос
|необязательный
|-
|целевая версия
|нить
|Фильтрует результирующий набор заданий обновления по целевой версии (обязательный формат <code><major>.<minor>.<revision></code>).
|запрос
|необязательный
|-
|последние обновления
|логический
|Если <code>true</code>, результирующий набор заданий обновления отфильтровывается до самого последнего обновления каждого типа.
|запрос
|необязательный
|}

== Ответ ==

=== Коды ответов ===
{| class="wikitable"
!Код
|Тип
!Описание
|-
|200
|Обновить Вакансии Все
|Успех
|-
|400
|Конверт ошибки
|Не удалось. Ввод недействителен.
|}

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

==== Объект _ <code>UpdateJobsAll</code> ====
Список ActiveGate с заданиями на обновление.
{| class="wikitable"
!Элемент
!Тип
!Описание
|-
|всеобновитьработы
|Обновить список заданий []
|Список ActiveGate с заданиями на обновление.

Может быть <code>null</code>.
|}

==== Объект _ <code>UpdateJobList</code> ====
Список заданий обновления ActiveGate.
{| class="wikitable"
!Элемент
!Тип
!Описание
|-
|agId
|нить
|Идентификатор ActiveGate.

Может быть <code>null</code>.
|-
|обновлениеJobs
|Обновить задание []
|Список заданий обновления ActiveGate.

Может быть <code>null</code>.
|}

==== Объект _ <code>UpdateJob</code> ====
Настройка задания обновления ActiveGate.
{| class="wikitable"
!Элемент
!Тип
!Описание
|-
|jobState
|нить
|Статус задания обновления.

Элемент может содержать эти значения

* <code>FAILED</code>
* <code>IN_PROGRESS</code>
* <code>PENDING</code>
* <code>ROLLBACK</code>
* <code>SCHEDULED</code>
* <code>SKIPPED</code>
* <code>SUCCEED</code>

Может быть <code>null</code>.
|-
|метод обновления
|нить
|Способ обновления ActiveGate или его компонентов.

Элемент может содержать эти значения

* <code>AUTOMATIC</code>
* <code>MANUAL_INSTALLATION</code>
* <code>ON_DEMAND</code>

Может быть <code>null</code>.
|-
|тип обновления
|нить
|Компонент, который нужно обновить.

Элемент может содержать эти значения

* <code>ACTIVE_GATE</code>
* <code>REMOTE_PLUGIN_AGENT</code>
* <code>SYNTHETIC</code>
* <code>Z_REMOTE</code>

Может быть <code>null</code>.
|-
|agType
|нить
|Тип ActiveGate.

Элемент может содержать эти значения

* <code>CLUSTER</code>
* <code>ENVIRONMENT</code>
* <code>ENVIRONMENT_MULTI</code>

Может быть <code>null</code>.
|-
|стартовая версия
|нить
|Начальная версия ActiveGate.

Может быть <code>null</code>.
|-
|среды
|строка []
|Список сред (определяемых идентификаторами), к которым может подключаться ActiveGate.

Может быть <code>null</code>.
|-
|отменяемый
|логический
|Задание может ( <code>true</code>) или не может ( <code>false</code>) быть отменено в данный момент.

Может быть <code>null</code>.
|-
|идентификатор задания
|нить
|Идентификатор задания обновления.

Может быть <code>null</code>.
|-
|отметка времени
|целое число
|Отметка времени завершения задания обновления.

Значение <code>null</code>означает, что задание все еще выполняется.

Может быть <code>null</code>.
|-
|продолжительность
|целое число
|Продолжительность обновления в миллисекундах.

Может быть <code>null</code>.
|-
|целевая версия
|нить
|Целевая версия обновления.

Укажите версию в <code><major>.<minor>.<revision>.<timestamp></code>формате.

Чтобы обновить до последней доступной версии, используйте <code>latest</code>значение.
|-
|ошибка
|нить
|Информация об ошибке обновления.

Может быть <code>null</code>.
|}

=== JSON-модель тела ответа ===
<code>{
"allUpdateJobs": [
{
"agId": "0x3efdd092",
"updateJobs": [
{
"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"
}
]
}
]
}</code>