Jump to

• Request
• Response

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 Top

Response

Supported Media Types

• application/json

200 Response

Successful operation - Fetch incident details

Body ()

Root Schema : Incident

Details of an incident

Match All

Details of an incident

Details of an incident

Show Source

• object IncidentSummary
  Summary of an incident
• object Incident-allOf[1]

{
    "description":"Details of an incident",
    "allOf":[
        {
            "$ref":"#/components/schemas/IncidentSummary"
        },
        {
            "type":"object",
            "properties":{
                "previousSeverity":{
                    "$ref":"#/components/schemas/Severity"
                },
                "eventsCount":{
                    "type":"integer",
                    "description":"Count of the related events",
                    "format":"int32",
                    "example":"1"
                },
                "symptomEventsCount":{
                    "type":"integer",
                    "description":"Count of the related symptom events",
                    "format":"int32"
                },
                "causeEventsCount":{
                    "type":"integer",
                    "description":"Count of the related cause events",
                    "format":"int32"
                },
                "compressionAttributes":{
                    "minItems":"0",
                    "type":"string",
                    "description":"List of event attributes used to group the events into this incident"
                },
                "diagnosticIncidentDetails":{
                    "$ref":"#/components/schemas/DiagnosticIncidentDetails"
                },
                "firstEventId":{
                    "type":"string",
                    "description":"ID of the first event for the incident",
                    "format":"raw",
                    "example":"C8141C5FCFBA348CE053860E4B6407E8"
                }
            }
        }
    ]
}

Nested Schema : IncidentSummary

Type: object

Summary of an incident

Show Source

• ageInHours: integer (int64)
  Read Only: true

  Incident age in hours

  Example: 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 incident

  Example: 35
• escalationLevel: object EscalationLevel
  Details of an escalation level
• id(required): string (raw)
  Read Only: true

  ID of the incident

  Example: 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 incident

  Example: 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 incident

  Example: 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 severities

  Example: CRITICAL
• status(required): string
  Current status of the incident

  Example: 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 created

  Example: 2021-06-16T12:17:56.000Z
• timeUpdated(required): string (date-time)
  Read Only: true

  Time when incident is updated

  Example: 2021-07-22T06:25:42.000Z

{
    "required":[
        "displayId",
        "id",
        "isOpen",
        "message",
        "severity",
        "status",
        "timeCreated",
        "timeUpdated"
    ],
    "type":"object",
    "properties":{
        "id":{
            "type":"string",
            "description":"ID of the incident",
            "format":"raw",
            "readOnly":true,
            "example":"C4E214A1172A2F19E053860E4B645AC7"
        },
        "displayId":{
            "type":"integer",
            "description":"Display ID of the incident",
            "format":"int64",
            "readOnly":true,
            "example":"35"
        },
        "message":{
            "type":"string",
            "description":"Message of the incident",
            "example":"CPU Utilization is 10.821%, crossed warning (5) or critical (10) threshold."
        },
        "targets":{
            "minItems":"0",
            "uniqueItems":true,
            "type":"array",
            "description":"Targets affected by this incident",
            "items":{
                "$ref":"#/components/schemas/Target"
            }
        },
        "nonTargetEntities":{
            "minItems":"0",
            "uniqueItems":true,
            "type":"array",
            "description":"Entities (jobs, etc.) other than targets which are affected by this incident",
            "items":{
                "$ref":"#/components/schemas/SourceEntity"
            }
        },
        "timeCreated":{
            "type":"string",
            "description":"Time when incident is created",
            "format":"date-time",
            "readOnly":true,
            "example":"2021-06-16T12:17:56.000Z"
        },
        "timeUpdated":{
            "type":"string",
            "description":"Time when incident is updated",
            "format":"date-time",
            "readOnly":true,
            "example":"2021-07-22T06:25:42.000Z"
        },
        "ageInHours":{
            "type":"integer",
            "description":"Incident age in hours",
            "format":"int64",
            "readOnly":true,
            "example":"855"
        },
        "isOpen":{
            "type":"boolean",
            "description":"Is the incident open?",
            "example":true
        },
        "status":{
            "type":"string",
            "description":"Current status of the incident",
            "example":"new"
        },
        "owner":{
            "type":"string",
            "description":"Current owner of the incident",
            "example":"SYSMAN"
        },
        "isEscalated":{
            "type":"boolean",
            "description":"Is the incident escalated?",
            "example":true
        },
        "escalationLevel":{
            "$ref":"#/components/schemas/EscalationLevel"
        },
        "priority":{
            "$ref":"#/components/schemas/Priority"
        },
        "suppressionStatus":{
            "$ref":"#/components/schemas/SuppressionStatus"
        },
        "severity":{
            "$ref":"#/components/schemas/Severity"
        },
        "canBeManuallyClosed":{
            "type":"boolean",
            "description":"Can the incident be cleared by user?",
            "example":true,
            "default":false
        },
        "ticket":{
            "$ref":"#/components/schemas/TicketSummary"
        },
        "isDiagnosticIncident":{
            "type":"boolean",
            "description":"Is it a Automatic Diagnostic Repository (ADR) incident?",
            "example":false,
            "default":false
        },
        "links":{
            "required":[
                "self"
            ],
            "type":"object",
            "properties":{
                "self":{
                    "$ref":"#/components/schemas/Link"
                }
            },
            "description":"URL links inside details of resource.",
            "readOnly":true,
            "example":{
                "self":{
                    "href":"/em/api/incidents/C4E214A1172A2F19E053860E4B645AC7"
                }
            }
        }
    },
    "description":"Summary of an incident"
}

Nested Schema : Incident-allOf[1]

Type: object

Show Source

• 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 events

  Example: 1
• firstEventId: string (raw)
  ID of the first event for the incident

  Example: C8141C5FCFBA348CE053860E4B6407E8
• previousSeverity: string
  Read Only: true

  Allowed Values: [ "FATAL", "CRITICAL", "WARNING", "MINOR_WARNING", "CLEAR" ]

  Supported list of the severities

  Example: CRITICAL
• symptomEventsCount: integer (int32)
  Count of the related symptom events

{
    "type":"object",
    "properties":{
        "previousSeverity":{
            "$ref":"#/components/schemas/Severity"
        },
        "eventsCount":{
            "type":"integer",
            "description":"Count of the related events",
            "format":"int32",
            "example":"1"
        },
        "symptomEventsCount":{
            "type":"integer",
            "description":"Count of the related symptom events",
            "format":"int32"
        },
        "causeEventsCount":{
            "type":"integer",
            "description":"Count of the related cause events",
            "format":"int32"
        },
        "compressionAttributes":{
            "minItems":"0",
            "type":"string",
            "description":"List of event attributes used to group the events into this incident"
        },
        "diagnosticIncidentDetails":{
            "$ref":"#/components/schemas/DiagnosticIncidentDetails"
        },
        "firstEventId":{
            "type":"string",
            "description":"ID of the first event for the incident",
            "format":"raw",
            "example":"C8141C5FCFBA348CE053860E4B6407E8"
        }
    }
}

Nested Schema : EscalationLevel

Type: object

Details of an escalation level

Show Source

• displayName: string
  Display name of the escalation level

  Example: None
• name(required): string
  Read Only: true

  Allowed Values: [ "NONE", "L1", "L2", "L3", "L4", "L5" ]

  Supported list of the escalataion levels

  Example: NONE

{
    "required":[
        "name"
    ],
    "type":"object",
    "properties":{
        "name":{
            "$ref":"#/components/schemas/EscalationLevels"
        },
        "displayName":{
            "type":"string",
            "description":"Display name of the escalation level",
            "example":"None"
        }
    },
    "description":"Details of an escalation level"
}

Nested Schema : links

Type: object

Read Only: true

URL links inside details of resource.

Show Source

• self(required): object Link
  A link referencing a REST API.

{
    "required":[
        "self"
    ],
    "type":"object",
    "properties":{
        "self":{
            "$ref":"#/components/schemas/Link"
        }
    },
    "description":"URL links inside details of resource.",
    "readOnly":true,
    "example":{
        "self":{
            "href":"/em/api/incidents/C4E214A1172A2F19E053860E4B645AC7"
        }
    }
}

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

{
    "minItems":"0",
    "uniqueItems":true,
    "type":"array",
    "description":"Entities (jobs, etc.) other than targets which are affected by this incident",
    "items":{
        "$ref":"#/components/schemas/SourceEntity"
    }
}

Nested Schema : Priority

Type: object

Details of an priority

Show Source

• displayName: string
  Read Only: true

  Display label for the priority

  Example: None
• name(required): string
  Internal name for the priority

  Example: PRIORITY_NONE

{
    "required":[
        "name"
    ],
    "type":"object",
    "properties":{
        "name":{
            "type":"string",
            "description":"Internal name for the priority",
            "example":"PRIORITY_NONE"
        },
        "displayName":{
            "type":"string",
            "description":"Display label for the priority",
            "readOnly":true,
            "example":"None"
        }
    },
    "description":"Details of an priority"
}

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

{
    "required":[
        "isSuppressed"
    ],
    "type":"object",
    "properties":{
        "isSuppressed":{
            "type":"boolean",
            "description":"Is the supression enabled?",
            "default":false
        },
        "suppressUntil":{
            "type":"string",
            "description":"Supression type",
            "enum":[
                "MANUALLY_UNSUPPRESSED",
                "INCIDENT_CLOSES",
                "INCIDENT_SEVERITY_CHANGES",
                "AFTER_A_DAY",
                "AFTER_A_WEEK",
                "AFTER_DATE"
            ]
        },
        "timeToEndSuppression":{
            "type":"string",
            "description":"Supression end time",
            "format":"date-time"
        }
    },
    "description":"Details of an suppression status"
}

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

{
    "minItems":"0",
    "uniqueItems":true,
    "type":"array",
    "description":"Targets affected by this incident",
    "items":{
        "$ref":"#/components/schemas/Target"
    }
}

Nested Schema : TicketSummary

Type: object

Read Only: true

Details of the ticket

Show Source

• id: string
  Read Only: true

  ID of the ticket

  Example: 51d62b6cd1384ba89aeddfa647ea1380
• status: string
  Status of the ticket

  Example: Triggered
• type: string
  Type of the ticket

  Example: TICKET
• url: string
  URL of the ticket

  Example: https://api.pagerduty.com/incidents?incident_key=F746283FHDKC

{
    "type":"object",
    "properties":{
        "id":{
            "type":"string",
            "description":"ID of the ticket",
            "readOnly":true,
            "example":"51d62b6cd1384ba89aeddfa647ea1380"
        },
        "status":{
            "type":"string",
            "description":"Status of the ticket",
            "example":"Triggered"
        },
        "type":{
            "type":"string",
            "description":"Type of the ticket",
            "example":"TICKET"
        },
        "url":{
            "type":"string",
            "description":"URL of the ticket",
            "example":"https://api.pagerduty.com/incidents?incident_key=F746283FHDKC"
        }
    },
    "description":"Details of the ticket",
    "readOnly":true
}

Nested Schema : Link

Type: object

A link referencing a REST API.

Show Source

• href: string
  Link URL

{
    "x-em-sdk-level":"emSDK",
    "description":"A link referencing a REST API.",
    "type":"object",
    "properties":{
        "href":{
            "description":"Link URL",
            "type":"string"
        }
    }
}

Nested Schema : SourceEntity

Type: object

Details of an source entity

Show Source

• id(required): string (raw)
  ID of the entity

  Example: 317C6AD6C69832D0ADDA279BEB7B7F32
• name(required): string
  Name of the entity

  Example: bkupjob-123456
• subTypeDisplayName: string
  Display name for sub type for an entity type

  Example: Database backup job
• subTypeName: string
  Sub type for an entity type

  Example: DBBackupJob
• typeDisplayName: string
  Display name for the entity type

  Example: Job
• typeName(required): string
  Type of the entity

  Example: JOB

{
    "required":[
        "id",
        "name",
        "typeName"
    ],
    "type":"object",
    "properties":{
        "id":{
            "type":"string",
            "description":"ID of the entity",
            "format":"raw",
            "example":"317C6AD6C69832D0ADDA279BEB7B7F32"
        },
        "name":{
            "type":"string",
            "description":"Name of the entity",
            "example":"bkupjob-123456"
        },
        "typeName":{
            "type":"string",
            "description":"Type of the entity",
            "example":"JOB"
        },
        "typeDisplayName":{
            "type":"string",
            "description":"Display name for the entity type",
            "example":"Job"
        },
        "subTypeName":{
            "type":"string",
            "description":"Sub type for an entity type",
            "example":"DBBackupJob"
        },
        "subTypeDisplayName":{
            "type":"string",
            "description":"Display name for sub type for an entity type",
            "example":"Database backup job"
        }
    },
    "description":"Details of an source entity"
}

Nested Schema : schema

Type: object

Target details

Show Source

• targetName: string
  Name of the target

  Example: sales_db1
• targetType: string
  Type of the target

  Example: oracle_database

{
    "description":"Target details",
    "type":"object",
    "properties":{
        "targetName":{
            "description":"Name of the target",
            "type":"string",
            "example":"sales_db1"
        },
        "targetType":{
            "description":"Type of the target",
            "type":"string",
            "example":"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

{
    "type":"object",
    "properties":{
        "problemDisplayId":{
            "type":"integer",
            "description":"All Oracle Automatic Diagnostic Incidents are grouped into a problem. This is the user visible identifier of the problem.",
            "format":"int32",
            "example":"29"
        },
        "problemId":{
            "type":"string",
            "description":"All Oracle Automatic Diagnostic Incidents are grouped into a problem. This is the queryable identifier of the problem.",
            "format":"raw",
            "example":"C4E06BA0653225EDE053860E4B6450BC"
        },
        "executionContextId":{
            "type":"string",
            "description":"Optional execution identified (ECID) provided for Oracle Automatic Diagnostic Incidents."
        }
    },
    "description":"Details of diagnostic incident"
}

400 Response

Bad Request

Body ()

Root Schema : ErrorResponse

Type: object

Response sent back in the case of an error.

Show Source

• code: string
  Status code of the error.

  Example: IllegalArgument
• message: string
  A descriptive error message.

  Example: argument given is not supported

{
    "x-em-sdk-level":"emSDK",
    "description":"Response sent back in the case of an error.",
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "description":"Status code of the error.",
            "example":"IllegalArgument"
        },
        "message":{
            "type":"string",
            "description":"A descriptive error message.",
            "example":"argument given is not supported"
        }
    }
}

401 Response

Unauthorized

Body ()

Root Schema : ErrorResponse

Type: object

Response sent back in the case of an error.

Show Source

• code: string
  Status code of the error.

  Example: IllegalArgument
• message: string
  A descriptive error message.

  Example: argument given is not supported

{
    "x-em-sdk-level":"emSDK",
    "description":"Response sent back in the case of an error.",
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "description":"Status code of the error.",
            "example":"IllegalArgument"
        },
        "message":{
            "type":"string",
            "description":"A descriptive error message.",
            "example":"argument given is not supported"
        }
    }
}

404 Response

Not Found

Body ()

Root Schema : ErrorResponse

Type: object

Response sent back in the case of an error.

Show Source

• code: string
  Status code of the error.

  Example: IllegalArgument
• message: string
  A descriptive error message.

  Example: argument given is not supported

{
    "x-em-sdk-level":"emSDK",
    "description":"Response sent back in the case of an error.",
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "description":"Status code of the error.",
            "example":"IllegalArgument"
        },
        "message":{
            "type":"string",
            "description":"A descriptive error message.",
            "example":"argument given is not supported"
        }
    }
}

500 Response

Internal Server Error

Body ()

Root Schema : ErrorResponse

Type: object

Response sent back in the case of an error.

Show Source

• code: string
  Status code of the error.

  Example: IllegalArgument
• message: string
  A descriptive error message.

  Example: argument given is not supported

{
    "x-em-sdk-level":"emSDK",
    "description":"Response sent back in the case of an error.",
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "description":"Status code of the error.",
            "example":"IllegalArgument"
        },
        "message":{
            "type":"string",
            "description":"A descriptive error message.",
            "example":"argument given is not supported"
        }
    }
}

503 Response

Service Unavailable

Body ()

Root Schema : ErrorResponse

Type: object

Response sent back in the case of an error.

Show Source

• code: string
  Status code of the error.

  Example: IllegalArgument
• message: string
  A descriptive error message.

  Example: argument given is not supported

{
    "x-em-sdk-level":"emSDK",
    "description":"Response sent back in the case of an error.",
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "description":"Status code of the error.",
            "example":"IllegalArgument"
        },
        "message":{
            "type":"string",
            "description":"A descriptive error message.",
            "example":"argument given is not supported"
        }
    }
}

Back to Top