Skip to main content

POST /service/tickets

Use this method to create a service ticket that was generated by a support service other than Call Home.

Authentication

Authentication with username and password is required.

Request URL

POST https://{management_server_IP}/service/tickets

Query parameters

None

Request body

AttributesRequired / OptionalTypeDescription
creationDateRequiredLongTimestamp when the service ticket was created
deviceUUIDRequired if machineType and serialNumber are not specified. Otherwise optional.StringUUID of the device that generated service ticket
Tip
This can be the UUID of a managed device or a device that is not managed by XClarity Administrator.
eventIDOptionalStringID of the event that generated service ticket
eventSequenceIDOptionalIntegerSequence ID of the event that generated the service ticket
lastUpdateDateOptionalLongTimestamp when the service ticket was updated last
machineModelRequired if deviceUUID is not specified. Otherwise optional.StringModel of the device that generated service ticket
machineTypeRequired if deviceUUID is not specified. Otherwise optional.StringMachine type of the device that generated service ticket
serialNumberRequired if deviceUUID is not specified. Otherwise optional.StringSerial number of the device that generated service ticket
statusRequiredStringStatus of the service ticket. This can be one of the following values.
  • Processing

  • Answered

  • Cancelled

  • Closed

  • Created

  • Error

  • Initialized

  • Rejected

  • Submitted

  • Unknown

  • Waiting

ticketIDRequiredStringID of the service ticket
ticketTypeRequiredStringSupport service that generated the service ticket. This can be one of the following values.
  • Cherwell
  • Service Now

The following example creates a service ticket that was generated by a support service other than Call Home.
{
"creationDate": "1366146000000",
"deviceUUID": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
"eventID": "FQXHMSS1045M",
"eventSequenceID": 120,
"lastUpdateDate": "1366147000000",
"machineModel": "AC1",
"machineType": "7903",
"serialNumber": "NANC009",
"status": "Created",
"ticketID": "USE0DSBNWWS",
"ticketType": "Cherwell"
}

Response codes

CodeDescriptionComments
200OKThe request completed successfully.
500Internal Server ErrorAn internal error occurred. A descriptive error message is returned in the response body.

Response body

None