Перечисляет все детали указанной проблемы.
Запрос создает application/json
полезную нагрузку.
GET | АппОптима | https://{your-domain}/e/{your-environment-id}/api/v2/problems/{problemId}
|
Cреда АктивногоШлюза | https://{your-activegate-domain}/e/{your-environment-id}/api/v2/problems/{problemId}
|
Аутентификация
Чтобы выполstring этот запрос, вам нужен токен доступа с областью чтения проблем ( problems.read
) . Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация .
Параметры
Параметр | Тип | Описание | In | Необходимость |
---|---|---|---|---|
problemId | string | ID требуемой проблемы. | path | требуется |
fields | string | Список дополнительных свойств проблемы, которые вы можете добавить к ответу.
Доступны следующие свойства (все остальные свойства включены всегда, и их нельзя удалить из ответа):
Чтобы добавить свойства, укажите их в виде списка, разделенного запятыми (например, |
query | по желанию |
Ответ
Некоторые модели JSON различаются в зависимости от типа модели. Чтобы найти все возможные варианты, обратитесь к моделям JSON .
Коды ответов
Код | Тип | Описание |
---|---|---|
200 | Problem | Успех |
Объекты тела ответа
Объект Problem
Свойства проблемы.
Элемент | Элемент | Описание |
---|---|---|
affectedEntities | EntityStub[] | Список всех объектов, затронутых проблемой. |
rootCauseEntity | EntityStub | Краткое представление отслеживаемого объекта. |
impactedEntities | EntityStub[] | Список всех объектов, затронутых проблемой. |
linkedProblemInfo | LinkedProblem | Свойства связанной задачи. |
problemFilters | AlertingProfileStub[] | Список профилей предупреждений, соответствующих проблеме. |
evidenceDetails | EvidenceDetails | Доказательства подробности проблемы. |
recentComments | CommentsList | Список комментариев. |
impactAnalysis | ImpactAnalysis | Список всех последствий проблемы. |
displayId | string | Идентификатор отображения проблемы. |
impactLevel | string | Уровень воздействия проблемы. Он показывает, на что влияет проблема.
Элемент может содержать эти значения
|
managementZones | ManagementZone[] | Список всех зон управления, к которым относится проблема. |
severityLevel | string | Серьезность проблемы.
Элемент может содержать эти значения
|
entityTags | METag[] | Список всех тегов сущностей проблемы. |
problemId | string | Идентификатор проблемы. |
status | string | Статус проблемы.
Элемент может содержать эти значения
|
startTime | integer | Отметка времени начала проблемы в миллисекундах UTC. |
endTime | integer | Отметка времени окончания проблемы в миллисекундах UTC.
Имеет |
title | string | Название проблемы, отображаемое в пользовательском интерфейсе. |
Объект EntityStub
Краткое представление отслеживаемого объекта.
Элемент | Тип | Описание |
---|---|---|
entityId | EntityId | Краткое представление отслеживаемого объекта. |
имя | string | Имя объекта.
Не включается в ответ, если объект с соответствующим идентификатором не найдена. |
Объект EntityId
Краткое представление отслеживаемого объекта.
Элемент | Тип | Описание |
---|---|---|
id | string | Идентификатор объекта. |
type | string | Тип объекта. |
Объект LinkedProblem
Свойства связанной задачи.
Элемент | Тип | Описание |
---|---|---|
displayId | string | Идентификатор отображения проблемы. |
problemId | string | Идентификатор проблемы. |
Объект AlertingProfileStub
Краткое представление профиля предупреждений.
Элемент | Тип | Описание |
---|---|---|
name | string | Имя профиля предупреждений. |
id | string | Идентификатор профиля оповещения. |
Объект EvidenceDetails
Доказательства подробности проблемы.
Элемент | Тип | Описание |
---|---|---|
totalCount | integer | Общее количество признаков проблемы. |
details | Evidence[] | Список всех доказательств. |
Объект Evidence
Доказательство первопричины.
Фактический набор полей зависит от типа свидетельства. Найдите список актуальных объектов в описании поляvideType или посмотрите модели Problems API v2-JSON .
Элемент | Тип | Описание |
---|---|---|
evidenceType | string | Определяет фактический набор полей в зависимости от значения. См. один из следующих объектов:
Элемент может содержать эти значения
|
displayName | string | Отображаемое имя свидетельства. |
entity | EntityStub | Краткое представление отслеживаемого объекта. |
groupingEntity | EntityStub | Краткое представление отслеживаемого объекта. |
rootCauseRelevant | boolean | Свидетельство является ( true ) или не является ( false ) частью первопричины.
|
startTime | integer | Время начала доказательства в миллисекундах UTC. |
Объект CommentsList
Список комментариев.
Элемент | Тип | Описание |
---|---|---|
comments | Comment[] | Записи результатов. |
pageSize | integer | Количество записей на странице. |
nextPageKey | string | Курсор для следующей страницы результатов. Имеет значение null на последней странице.
Используйте его в параметре запроса nextPageKey для получения последующих страниц результата. |
totalCount | integer | Общее количество записей в результате. |
Объект Comment
Комментарий к проблеме.
Элемент | Тип | Описание |
---|---|---|
authorName | string | Пользователь, написавший комментарий. |
createdAtTimestamp | integer | Отметка времени создания комментария в миллисекундах UTC. |
context | string | Контекст комментария. |
id | string | Идентификатор комментария. |
content | string | Текст комментария. |
Объект ImpactAnalysis
Список всех последствий проблемы.
Элемент | Тип | Описание |
---|---|---|
impacts | Impact[] | Список всех последствий проблемы. |
Объект Impact
Анализ воздействия проблемы на другие объекты/пользователей.
Фактический набор полей зависит от типа воздействия. Найдите список актуальных объектов в описании поля ImpactType или посмотрите модели Problems API v2-JSON .
Элемент | Тип | Описание |
---|---|---|
impactType | string | Определяет фактический набор полей в зависимости от значения. См. один из следующих объектов:
Элемент может содержать эти значения
|
impactedEntity | EntityStub | Краткое представление отслеживаемого объекта. |
estimatedAffectedUsers | integer | Предполагаемое количество затронутых пользователей. |
Объект ManagementZone
Краткое представление зоны управления.
Элемент | Тип | Описание |
---|---|---|
name | string | Имя зоны управления. |
id | string | Идентификатор зоны управления. |
Объект METag
Тег отслеживаемого объекта.
Элемент | Тип | Описание |
---|---|---|
stringRepresentation | string | Строковое представление тега. |
value | string | Значение тега. |
key | string | Ключ тега. |
context | string | Происхождение тега, например AWS или Cloud Foundry.
Пользовательские теги используют это |
JSON-модель тела ответа
<{ "affectedEntities": [ { "entityId": { "id": "string", "type": "string" }, "name": "string" } ], "rootCauseEntity": {}, "impactedEntities": [ {} ], "linkedProblemInfo": { "displayId": "string", "problemId": "string" }, "problemFilters": [ { "name": "string", "id": "string" } ], "evidenceDetails": { "totalCount": 1, "details": [ { "evidenceType": "AVAILABILITY_EVIDENCE", "displayName": "string", "entity": {}, "groupingEntity": {}, "rootCauseRelevant": true, "startTime": 1 } ] }, "recentComments": { "comments": [ { "authorName": "string", "createdAtTimestamp": 1, "context": "string", "id": "string", "content": "string" } ], "pageSize": 1, "nextPageKey": "AQAAABQBAAAABQ==", "totalCount": 1 }, "impactAnalysis": { "impacts": [ { "impactType": "APPLICATION", "impactedEntity": {}, "estimatedAffectedUsers": 1 } ] }, "displayId": "string", "impactLevel": "APPLICATION", "managementZones": [ { "name": "string", "id": "string" } ], "severityLevel": "AVAILABILITY", "entityTags": [ { "stringRepresentation": "string", "value": "string", "key": "string", "context": "string" } ], "problemId": "string", "status": "CLOSED", "startTime": 1, "endTime": 1, "title": "string" }