Search Outage Events

post

/rest/apis/customer/service/outageEvent/search

This operation returns outage events for a given account and person.

Request

There are no request parameters for this operation.

Supported Media Types
Request Body - application/xml ()
Root Schema : schema
Type: object
Show Source
Nested Schema : filters
Type: object
Show Source
Request Body - application/json ()
Root Schema : schema
Type: object
Show Source
Nested Schema : filters
Type: object
Show Source
Back to Top

Response

Supported Media Types

200 Response

Success response
Body ()
Root Schema : C1OutagSerch
Type: object
Show Source
Nested Schema : outageEvents
Type: array
Show Source
Nested Schema : items
Type: object
Show Source
  • The completed restoration or cancellation time of the outage event.
    Example: 2025-02-07T12:00:00-08:00
  • The estimated restoration time of the outage event.
    Example: 2025-02-07T12:00:00-08:00
  • The external outage management system sends the event state, which is mapped to a customizable lookup value. If the value exceeds four characters, the service uses the Java name attribute for mapping.
    Example: NEW
  • Maximum Length: 256
    The description for outage event status values available from the outage system.
    Example: New unacknowledged event
  • Maximum Length: 254
    The unique identifier of the outage event in the outage management system.
    Example: 200234
  • Maximum Length: 30
    The unique identifier of the outage management system reporting the outage information. This should be a valid reference to an external system record.
    Example: CCB-NMS integration
  • locations
  • Maximum Length: 14
    The unique system generated primary key of the outage event record.
  • Allowed Values: [ "C1AC", "C1RR", "C1SC" ]
    This field indicates if outage status is active or scheduled. * `C1AC` - Active, * `C1RR` - Recently Restored, * `C1SC` - Scheduled
    Example: C1AC
  • Allowed Values: [ "C1PL", "C1UP" ]
    The Outage Type specifies whether the outage was planned or not. * `C1PL` - Planned, * `C1UP` - Unplanned
    Example: C1PL
  • Maximum Length: 254
    The language description for the primary cause of the outage event if available from the outage system. Typically, values can be selected from a configured list such as weather, environment, and so on.
    Example: Trouble Call
  • The recorded start date and time of the outage event.
    Example: 2025-02-06T02:00:00-08:00
  • The last updated date and time of the outage event.
Nested Schema : locations
Type: array
Show Source
Nested Schema : items
Type: object
Show Source
  • Maximum Length: 10
    Account ID
  • Maximum Length: 254
    The Account Name stored as a characteristic.
  • Maximum Length: 10
    The Premise ID associated with a service disruption caused by the outage event.
  • Maximum Length: 254
    The information string for the premise that is used in the application. The content is controlled by a plug-in algorithm on the installation record.

400 Response

Bad Request
Body ()
Root Schema : problemDetailDocument
Type: object
Show Source
  • Maximum Length: 60
    The long message description from the Oracle Utilities Application Framework in CDATA format.
  • Minimum Value: 0
    Maximum Value: 9999
    The HTTP Status code for the error.
  • Maximum Length: 60
    Fully qualified URL consisting of the Base URI Timestamp of error in ISO format, the User used for the transaction, the Message Category within Oracle Utilities Application Framework, the Message Number within Oracle Utilities Application Framework, the Request URL and the HTTP method used for the transaction.
  • Maximum Length: 60
    URL of the format "A/message/X/Y" where A is the base URI, X is the Message Category and Y is the Message Number within Oracle Utilities Application Framework.
  • serverMessage
  • Maximum Length: 60
    The stack trace shows where the error occurs during the execution of a program.
  • Maximum Length: 60
    Fully qualified error message from Oracle Utilities Application Framework in CDATA format.
Nested Schema : serverMessage
Type: object
Show Source
  • Maximum Length: 60
    Delimited sequence of programs called.
  • Maximum Length: 60
    The long message description from the Oracle Utilities Application Framework in CDATA format.
  • Minimum Value: 0
    Maximum Value: 0
    Message Category within Oracle Utilities Application Framework.
  • Minimum Value: -99999
    Maximum Value: 99999
    Message Number within Oracle Utilities Application Framework.
  • Maximum Length: 60
    Fully qualified error message from Oracle Utilities Application Framework in CDATA format.
  • Maximum Length: 60
    Name of the program that encountered the error.

500 Response

Internal Server Error
Body ()
Root Schema : problemDetailDocument
Type: object
Show Source
  • Maximum Length: 60
    The long message description from the Oracle Utilities Application Framework in CDATA format.
  • Minimum Value: 0
    Maximum Value: 9999
    The HTTP Status code for the error.
  • Maximum Length: 60
    Fully qualified URL consisting of the Base URI Timestamp of error in ISO format, the User used for the transaction, the Message Category within Oracle Utilities Application Framework, the Message Number within Oracle Utilities Application Framework, the Request URL and the HTTP method used for the transaction.
  • Maximum Length: 60
    URL of the format "A/message/X/Y" where A is the base URI, X is the Message Category and Y is the Message Number within Oracle Utilities Application Framework.
  • serverMessage
  • Maximum Length: 60
    The stack trace shows where the error occurs during the execution of a program.
  • Maximum Length: 60
    Fully qualified error message from Oracle Utilities Application Framework in CDATA format.
Nested Schema : serverMessage
Type: object
Show Source
  • Maximum Length: 60
    Delimited sequence of programs called.
  • Maximum Length: 60
    The long message description from the Oracle Utilities Application Framework in CDATA format.
  • Minimum Value: 0
    Maximum Value: 0
    Message Category within Oracle Utilities Application Framework.
  • Minimum Value: -99999
    Maximum Value: 99999
    Message Number within Oracle Utilities Application Framework.
  • Maximum Length: 60
    Fully qualified error message from Oracle Utilities Application Framework in CDATA format.
  • Maximum Length: 60
    Name of the program that encountered the error.
Back to Top