Find incident by ID
get
https://EM_HOST:EM_CONSOLE_HTTPS_PORT/em/api/incidents/{incidentId}
Get the details of the incident matching the incident ID
Request
Path Parameters
-
incidentId(required): string(raw)
ID of the incident
There's no request body for this operation.
Back to TopResponse
Supported Media Types
- application/json
200 Response
Successful operation - Fetch incident details
Root Schema : Incident
Details of an incident
Match All
Show Source
-
object
IncidentSummary
Summary of an incident
-
object
Incident-allOf[1]
Nested Schema : IncidentSummary
Type:
object
Summary of an incident
Show Source
-
ageInHours: integer
(int64)
Read Only:
true
Incident age in hoursExample:855
-
canBeManuallyClosed: boolean
Default Value:
false
Can the incident be cleared by user?Example:true
-
displayId(required): integer
(int64)
Read Only:
true
Display ID of the incidentExample:35
-
escalationLevel: object
EscalationLevel
Details of an escalation level
-
id(required): string
(raw)
Read Only:
true
ID of the incidentExample:C4E214A1172A2F19E053860E4B645AC7
-
isDiagnosticIncident: boolean
Default Value:
false
Is it a Automatic Diagnostic Repository (ADR) incident?Example:false
-
isEscalated: boolean
Is the incident escalated?Example:
true
-
isOpen(required): boolean
Is the incident open?Example:
true
-
links: object
links
Read Only:
true
URL links inside details of resource. -
message(required): string
Message of the incidentExample:
CPU Utilization is 10.821%, crossed warning (5) or critical (10) threshold.
-
nonTargetEntities: array
nonTargetEntities
Minimum Number of Items:
0
Unique Items Required:true
Entities (jobs, etc.) other than targets which are affected by this incident -
owner: string
Current owner of the incidentExample:
SYSMAN
-
priority: object
Priority
Details of an priority
-
severity(required): string
Read Only:
true
Allowed Values:[ "FATAL", "CRITICAL", "WARNING", "MINOR_WARNING", "CLEAR" ]
Supported list of the severitiesExample:CRITICAL
-
status(required): string
Current status of the incidentExample:
new
-
suppressionStatus: object
SuppressionStatus
Details of an suppression status
-
targets: array
targets
Minimum Number of Items:
0
Unique Items Required:true
Targets affected by this incident -
ticket: object
TicketSummary
Read Only:
true
Details of the ticket -
timeCreated(required): string
(date-time)
Read Only:
true
Time when incident is createdExample:2021-06-16T12:17:56.000Z
-
timeUpdated(required): string
(date-time)
Read Only:
true
Time when incident is updatedExample:2021-07-22T06:25:42.000Z
Nested Schema : Incident-allOf[1]
Type:
Show Source
object
-
causeEventsCount: integer
(int32)
Count of the related cause events
-
compressionAttributes: string
List of event attributes used to group the events into this incident
-
diagnosticIncidentDetails: object
DiagnosticIncidentDetails
Details of diagnostic incident
-
eventsCount: integer
(int32)
Count of the related eventsExample:
1
-
firstEventId: string
(raw)
ID of the first event for the incidentExample:
C8141C5FCFBA348CE053860E4B6407E8
-
previousSeverity: string
Read Only:
true
Allowed Values:[ "FATAL", "CRITICAL", "WARNING", "MINOR_WARNING", "CLEAR" ]
Supported list of the severitiesExample:CRITICAL
-
symptomEventsCount: integer
(int32)
Count of the related symptom events
Nested Schema : EscalationLevel
Type:
object
Details of an escalation level
Show Source
-
displayName: string
Display name of the escalation levelExample:
None
-
name(required): string
Read Only:
true
Allowed Values:[ "NONE", "L1", "L2", "L3", "L4", "L5" ]
Supported list of the escalataion levelsExample:NONE
Nested Schema : links
Type:
object
Read Only:
true
URL links inside details of resource.
Show Source
-
self(required): object
Link
Represents a link(could be self, previous or next)
Example:
{
"self":{
"href":"/em/api/incidents/C4E214A1172A2F19E053860E4B645AC7"
}
}
Nested Schema : nonTargetEntities
Type:
array
Minimum Number of Items:
0
Unique Items Required:
true
Entities (jobs, etc.) other than targets which are affected by this incident
Show Source
-
Array of:
object SourceEntity
Details of an source entity
Nested Schema : Priority
Type:
object
Details of an priority
Show Source
-
displayName: string
Read Only:
true
Display label for the priorityExample:None
-
name(required): string
Internal name for the priorityExample:
PRIORITY_NONE
Nested Schema : SuppressionStatus
Type:
object
Details of an suppression status
Show Source
-
isSuppressed(required): boolean
Default Value:
false
Is the supression enabled? -
suppressUntil: string
Allowed Values:
[ "MANUALLY_UNSUPPRESSED", "INCIDENT_CLOSES", "INCIDENT_SEVERITY_CHANGES", "AFTER_A_DAY", "AFTER_A_WEEK", "AFTER_DATE" ]
Supression type -
timeToEndSuppression: string
(date-time)
Supression end time
Nested Schema : targets
Type:
array
Minimum Number of Items:
0
Unique Items Required:
true
Targets affected by this incident
Show Source
-
Array of:
object schema
Target details
Nested Schema : TicketSummary
Type:
object
Read Only:
true
Details of the ticket
Show Source
-
id: string
Read Only:
true
ID of the ticketExample:51d62b6cd1384ba89aeddfa647ea1380
-
status: string
Status of the ticketExample:
Triggered
-
type: string
Type of the ticketExample:
TICKET
-
url: string
URL of the ticketExample:
https://api.pagerduty.com/incidents?incident_key=F746283FHDKC
Nested Schema : Link
Type:
object
Represents a link(could be self, previous or next)
Show Source
-
href: string
URL for LinkExample:
/em/api/<resources>?page=b2Zmc2V0OjA&limit=0
Nested Schema : SourceEntity
Type:
object
Details of an source entity
Show Source
-
id(required): string
(raw)
ID of the entityExample:
317C6AD6C69832D0ADDA279BEB7B7F32
-
name(required): string
Name of the entityExample:
bkupjob-123456
-
subTypeDisplayName: string
Display name for sub type for an entity typeExample:
Database backup job
-
subTypeName: string
Sub type for an entity typeExample:
DBBackupJob
-
typeDisplayName: string
Display name for the entity typeExample:
Job
-
typeName(required): string
Type of the entityExample:
JOB
Nested Schema : schema
Type:
object
Target details
Show Source
-
targetName: string
Name of the targetExample:
sales_db1
-
targetType: string
Type of the targetExample:
oracle_database
Nested Schema : DiagnosticIncidentDetails
Type:
object
Details of diagnostic incident
Show Source
-
executionContextId: string
Optional execution identified (ECID) provided for Oracle Automatic Diagnostic Incidents.
-
problemDisplayId: integer
(int32)
All Oracle Automatic Diagnostic Incidents are grouped into a problem. This is the user visible identifier of the problem.Example:
29
-
problemId: string
(raw)
All Oracle Automatic Diagnostic Incidents are grouped into a problem. This is the queryable identifier of the problem.Example:
C4E06BA0653225EDE053860E4B6450BC
400 Response
Bad Request
Root Schema : ErrorResponse
Type:
object
Error response
Show Source
-
code(required): string
A short error code that defines the error, meant for programmatic parsing
-
message(required): string
A human-readable error string
401 Response
Unauthorized
Root Schema : ErrorResponse
Type:
object
Error response
Show Source
-
code(required): string
A short error code that defines the error, meant for programmatic parsing
-
message(required): string
A human-readable error string
404 Response
Not Found
Root Schema : ErrorResponse
Type:
object
Error response
Show Source
-
code(required): string
A short error code that defines the error, meant for programmatic parsing
-
message(required): string
A human-readable error string
500 Response
Internal Server Error
Root Schema : ErrorResponse
Type:
object
Error response
Show Source
-
code(required): string
A short error code that defines the error, meant for programmatic parsing
-
message(required): string
A human-readable error string
503 Response
Service Unavailable
Root Schema : ErrorResponse
Type:
object
Error response
Show Source
-
code(required): string
A short error code that defines the error, meant for programmatic parsing
-
message(required): string
A human-readable error string