Список всех доступных выпусков.
Запрос создает application/jsonполезную нагрузку.
| ПОЛУЧИТЬ | Удалось | https://{your-domain}/e/{your-environment-id}/api/v2/releases
|
| SaaS | https://{your-environment-id}.live.dynatrace.com/api/v2/releases
| |
| Окружающая среда ActiveGate | https://{your-activegate-domain}/e/{your-environment-id}/api/v2/releases
|
Аутентификация
Чтобы выполнить этот запрос, вам нужен токен доступа с областью чтения релизов ( releases.read) . Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация .
Параметры
| Параметр | Тип | Описание | В | Необходимый |
|---|---|---|---|---|
| из | нить | Начало запрошенного таймфрейма.
Вы можете использовать один из следующих форматов:
Если не задано, используется относительный двухнедельный таймфрейм ( |
запрос | по желанию |
| к | нить | Конец запрошенного периода времени.
Вы можете использовать один из следующих форматов:
Если не установлено, используется текущая метка времени. |
запрос | по желанию |
| ключ следующей страницы | нить | Курсор для следующей страницы результатов. Вы можете найти его в поле nextPageKey предыдущего ответа.
Первая страница всегда возвращается, если вы не укажете параметр запроса nextPageKey . Когда nextPageKey настроен на получение последующих страниц, вы должны опустить все остальные параметры запроса. |
запрос | по желанию |
| размер страницы | целое число | Количество релизов в полезной нагрузке одного ответа.
Максимально допустимый размер страницы — 1000. Если не установлено, используется 100. |
запрос | по желанию |
| демо | логический | Получите ваши Релизы ( false) или набор демонстрационных Релизов ( true).
|
запрос | по желанию |
| релизыСелектор | нить | Определяет область запроса. В ответ включаются только Релизы, соответствующие указанным критериям.
Вы можете добавить один или несколько из перечисленных ниже критериев.
Чтобы задать несколько критериев, разделите их запятой (,). В ответ включаются только результаты, соответствующие всем критериям. например, .../api/v2/releases?releasesSelector=name("Сервер"),monitoringState("Активный"),healthState("ЗДОРОВЫЙ"),releasesVersion("1.0.7"). Специальные символы ~ и " необходимо экранировать с помощью символа ~ (например, поиск в двойных кавычках entityName("~"")). |
запрос | по желанию |
| Сортировать | нить | Указывает поле, используемое для сортировки списка релизов. Поле имеет знаковый префикс (+/-), который соответствует порядку сортировки («+» по возрастанию и «-» по убыванию). Если префикс знака не установлен, будет применяться порядок сортировки по возрастанию по умолчанию. Вы можете сортировать по следующим свойствам:
Если не задано, применяется сортировка имени по возрастанию. |
запрос | по желанию |
Ответ
Коды ответов
| Код | Тип | Описание |
|---|---|---|
| 200 | Релизы | Успех |
| 400 | ErrorEnvelope | Не удалось. Ввод недействителен. |
Объекты тела ответа
Объект _ Releases
Список релизов.
| Элемент | Тип | Описание |
|---|---|---|
| выпускает | Выпустить [] | Список релизов. |
| релизыWithProblems | целое число | Количество релизов с проблемами. |
| размер страницы | целое число | Количество записей на странице. |
| ключ следующей страницы | нить | Курсор для следующей страницы результатов. Имеет значение nullна последней странице.
Используйте его в параметре запроса nextPageKey для получения последующих страниц результата. |
| общее количество | целое число | Общее количество записей в результате. |
Объект _ Release
Содержит данные, относящиеся к одному выпуску компонента. Релиз — это комбинация компонента и версии. Компонент может быть любой формой развертывания, которая может быть связана с версией. В первом наброске Компонент всегда является Сервисом.
Кортеж <name, product, stage, version> всегда уникален.
| Элемент | Тип | Описание |
|---|---|---|
| securityVulnerabilitiesCount | целое число | Количество уязвимостей безопасности объекта |
| ReleaseEntityId | нить | Идентификатор объекта коррелирующего выпуска. |
| пропускная способность | количество | Количество байтов в секунду объекта |
| securityVulnerabilitiesEnabled | логический | Указывает, что функция уязвимостей безопасности включена. |
| затронутыеBySecurityVulnerabilities | логический | Объект имеет одну или несколько уязвимостей безопасности |
| программное обеспечениеTechs | Специалисты по программному обеспечению [ ] | Программные технологии выпуска |
| затронутоByProblems | логический | У организации есть одна или несколько проблем |
| товар | нить | Название продукта |
| экземпляры | Выпустить экземпляр [] | Экземпляры entityId, включенные в этот выпуск |
| Бег | логический | Соответствующий PGI все еще работает/отслеживается |
| имя | нить | Имя объекта |
| версия | нить | Идентифицированная версия выпуска |
| проблемаКоличество | целое число | Количество проблем организации |
| сцена | нить | Сценическое имя |
Объект _ SoftwareTechs
Содержит информацию об используемой программной технологии.
| Элемент | Тип | Описание |
|---|---|---|
| технологии | нить | Тип технологии. |
| версия | нить | Издание техники. |
| verbatimType | нить | Дословный тип технологии. |
| версия | нить | Версия технологии. |
Объект _ ReleaseInstance
Содержит данные, относящиеся к одному экземпляру выпуска. Экземпляр является экземпляром группы процессов и имеет необязательную версию сборки.
| Элемент | Тип | Описание |
|---|---|---|
| версия сборки | нить | Версия сборки |
| безопасностьУязвимости | строка [] | Список идентификаторов уязвимостей безопасности |
| идентификатор объекта | нить | Идентификатор сущности экземпляра. |
| проблемы | строка [] | Список идентификаторов событий открытых проблем |
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
}