GET релизы
Список всех доступных выпусков.
Запрос создает application/json
полезную нагрузку.
GET | Managed | https://{your-domain}/e/{your-environment-id}/api/v2/releases
|
Среда АктивногоШлюза | https://{your-activegate-domain}/e/{your-environment-id}/api/v2/releases
|
Аутентификация
Чтобы выполstring этот запрос, вам нужен токен доступа с областью чтения релизов ( releases.read
) . Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация .
Параметры
Параметр | Тип | Описание | В | Необходимый |
---|---|---|---|---|
from | string | Начало запрошенного таймфрейма.
Вы можете использовать один из следующих форматов:
Если не задано, используется относительный двухнедельный таймфрейм ( |
запрос | по желанию |
to | string | Конец запрошенного периода времени.
Вы можете использовать один из следующих форматов:
Если не установлено, используется текущая метка времени. |
запрос | по желанию |
nextPageKey | string | Курсор для следующей страницы результатов. Вы можете найти его в поле nextPageKey предыдущего ответа.
Первая страница всегда возвращается, если вы не укажете параметр запроса nextPageKey . Когда nextPageKey настроен на получение последующих страниц, вы должны опустить все остальные параметры запроса. |
запрос | по желанию |
pageSize | integer | Количество релизов в полезной нагрузке одного ответа.
Максимально допустимый размер страницы — 1000. Если не установлено, используется 100. |
запрос | по желанию |
demo | boolean | Получите ваши Релизы ( false ) или набор демонстрационных Релизов ( true ).
|
запрос | по желанию |
releasesSelector | string | Определяет область запроса. В ответ включаются только Релизы, соответствующие указанным критериям.
Вы можете добавить один или несколько из перечисленных ниже критериев.
Чтобы задать несколько критериев, разделите их запятой (,). В ответ включаются только результаты, соответствующие всем критериям. например, .../api/v2/releases?releasesSelector=name("Сервер"),monitoringState("Активный"),healthState("ЗДОРОВЫЙ"),releasesVersion("1.0.7"). Специальные символы ~ и " необходимо экранировать с помощью символа ~ (например, поиск в двойных кавычках entityName("~"")). |
запрос | по желанию |
sort | string | Указывает поле, используемое для сортировки списка релизов. Поле имеет знаковый префикс (+/-), который соответствует порядку сортировки («+» по возрастанию и «-» по убыванию). Если префикс знака не установлен, будет применяться порядок сортировки по возрастанию по умолчанию. Вы можете сортировать по следующим свойствам:
Если не задано, применяется сортировка имени по возрастанию. |
запрос | по желанию |
Ответ
Коды ответов
Код | Тип | Описание |
---|---|---|
200 | Releases | Успех |
400 | ErrorEnvelope | Не удалось. Ввод недействителен. |
Объекты тела ответа
Объект Releases
Список релизов.
Элемент | Тип | Описание |
---|---|---|
releases | Release[] | Список релизов. |
releasesWithProblems | integer | Количество релизов с проблемами. |
nextPageKey | string | Количество записей на странице. |
pageSize | integer | Курсор для следующей страницы результатов. Имеет значение null на последней странице.
Используйте его в параметре запроса nextPageKey для получения последующих страниц результата. |
totalCount | integer | Общее количество записей в результате. |
Объект Release
Содержит данные, относящиеся к одному выпуску компонента. Релиз — это комбинация компонента и версии. Компонент может быть любой формой развертывания, которая может быть связана с версией. В первом наброске Компонент всегда является Сервисом.
Запись <name, product, stage, version> всегда уникален.
Элемент | Тип | Описание |
---|---|---|
releaseEntityId | string | Идентификатор объекта коррелирующего выпуска. |
securityVulnerabilitiesCount | integer | Количество уязвимостей безопасности объекта |
affectedByProblems | boolean | У объекта есть одна или несколько проблем |
securityVulnerabilitiesEnabled | boolean | Указывает, что функция уязвимостей безопасности включена. |
affectedBySecurityVulnerabilities | boolean | Объект имеет одну или несколько уязвимостей безопасности |
throughput | number | Количество байтов в секунду объекта |
softwareTechs | SoftwareTechs[] | Программные технологии выпуска |
product | string | Название продукта |
instances | ReleaseInstance[] | Экземпляры entityId, включенные в этот выпуск |
version | string | Идентифицированная версия выпуска |
running | boolean | Соответствующий PGI все еще работает/отслеживается |
problemCount | integer | Количество проблем объекта |
stage | string | Имя стадии |
name | string | Имя объекта |
Объект SoftwareTechs
Содержит информацию об используемой программной технологии.
Элемент | Тип | Описание |
---|---|---|
edition | string | Тип технологии. |
verbatimType | string | Издание техники. |
technology | string | Дословный тип технологии. |
version | string | Версия технологии. |
Объект ReleaseInstance
Содержит данные, относящиеся к одному экземпляру выпуска. Экземпляр является экземпляром группы процессов и имеет необязательную версию сборки.
Элемент | Тип | Описание |
---|---|---|
buildVersion | string | Версия сборки |
securityVulnerabilities | string [] | Список идентификаторов уязвимостей безопасности |
entityId | string | Идентификатор сущности экземпляра. |
problems | string [] | Список идентификаторов событий открытых проблем |
JSON-модель тела ответа
{
"releases": [
{
"securityVulnerabilitiesCount": 4,
"releaseEntityId": "PROCESS_GROUP-DFDBAC9CBF104253",
"throughput": 923234,
"securityVulnerabilitiesEnabled": true,
"affectedBySecurityVulnerabilities": true,
"softwareTechs": [
{
"technology": "JAVA",
"edition": "OpenJDK",
"version": "1.8.0_242",
"verbatimType": "Java"
}
],
"affectedByProblems": true,
"product": "Sockshop",
"instances": [
"PROCESS_GROUP_INSTANCE-49D94B90FB71C45B",
"PROCESS_GROUP_INSTANCE-7EA049157C82D1A5"
],
"running": true,
"name": "cluster",
"version": "1.195.34.12341232423-012342",
"problemCount": 4,
"stage": "staging"
}
],
"releasesWithProblems": 1,
"pageSize": 1,
"nextPageKey": "AQAAABQBAAAABQ==",
"totalCount": 1
}