Get details of the associated tickets for the alert
/serviceapi/eventServices/alerts/{alertId}/tickets
Retrieves details of the associated tickets for the alert.
Request
- application/json
-
alertId: string
The id of the alert
-
limit(optional): integer(int32)
the number of entries in the result to be returend in one REST callDefault Value:
50
-
offset(optional): integer(int32)
the offset into the result list when doing a query with limitDefault Value:
0
Response
- application/json
200 Response
object
It is describing the list of tickets returned in response to an alert tickets request.
-
count:
integer(int32)
The number of items in the list
-
hasMore:
boolean
Default Value:
false
Indicates if there are more items -
items:
array items
The items
-
nextLink(optional):
string
The link to get the next chunk of items (if paging)
-
previousLink(optional):
string
The link to the previous chunk of items (if paging)
array
-
Array of:
object AlertTicketInfo
It is possible to configure alert rules to create/update tickets in external ticketing systems for the alerts managed in Oracle Management Cloud. Each ticket (associated with an alert) has various properties that describe it. The ticket is uniquely identified by its id in Oracle Management Cloud. The reference id is the corresponding identifier in the ticketing system. The status property corresponds to its current status in the ticketing system. Associated ticket can be accessed via the url.
object
It is possible to configure alert rules to create/update tickets in external ticketing systems for the alerts managed in Oracle Management Cloud. Each ticket (associated with an alert) has various properties that describe it. The ticket is uniquely identified by its id in Oracle Management Cloud. The reference id is the corresponding identifier in the ticketing system. The status property corresponds to its current status in the ticketing system. Associated ticket can be accessed via the url.
-
openTime:
string
The time (in UTC) when ticket was openedExample:
2020-09-02T19:41:53.281Z
-
referenceId:
string
The reference id in ticketing systemExample:
fe81b96fa5f572651348495dd4b97735
-
status:
string
The status of ticket in ticketing systemExample:
New
-
ticketId:
string
The ticket id in Oracle Management CloudExample:
INC0000026
-
ticketType:
string
The type of ticketing systemExample:
ServiceNow
-
updatedTime:
string
The last time (in UTC) when ticket was updatedExample:
2020-09-02T19:51:56.032Z
-
url:
string
The url to access ticket in ticketing systemExample:
https://demo.service-now.com/nav_to.do?uri=incident.do?sys_id=fe81b96fa5f572651348495dd4b97735%26sysparm_view=ess
400 Response
object
When invalid alert API request is received, alert system returns this response.
-
errorCode:
string
The alert system's internal error code
-
errorMessage:
string
The alert system's internal error message
-
httpMessage:
string
The http error message
-
httpStatusCode:
string
Default Value:
400
The http status code
500 Response
object
When alert system runs into unhandled exception, it returns this response.
-
errorCode:
string
Default Value:
general_error
The alert system's error code for unhandled exception -
errorMessage:
string
Default Value:
Internal Server Error
The alert system's error message for unhandled exception -
httpMessage:
string
Default Value:
Internal Server Error
The http error message -
httpStatusCode:
string
Default Value:
500
The http status code
Examples
Get details of the associated tickets for the alert
curl -u ${OMC_USERNAME}:${PASSWORD} -X GET "https://serverurl/serviceapi/eventServices/alerts/62965132339213727047162539738389170623/tickets"
The response might look like the following:
{ "items": [ { "status": "New", "updatedTime": "2020-08-05T06:44:10.327Z", "referenceId": "fe81b96fa5f572651348495dd4b97735", "url": "https://demo.service-now.com/nav_to.do?uri=incident.do?sys_id=fe81b96fa5f572651348495dd4b97735%26sysparm_view=ess", "ticketType": "ServiceNow", "openTime": "2020-08-05T06:44:10.327Z", "ticketId": "INC0000026" } ], "hasMore": false, "count": 1 }Back to Top