Whenever you use REST APIs for PubSub+ Cloud, a response is returned to indicate success or errors using standard 2xx, 4xx, and 5xx HTTP response codes as documented for each REST endpoint but we have provided a summary for your convenience of all the possible codes. Specific error information is available in the response when an error occurs.

HTTP Response Codes

The REST API uses the following common, response codes. For errors, the response includes an error object that gives you more details about the error.

Error Codes

You can use the message, errorId, and validationDetails keys to get more information on what occurred incorrectly. The string value in the message key may have more information as to why the error occurred.

The following response shows the JSON object that is returned as part of the40x or 50x HTTP response.

{
  message: "Unable to create messaging service US-EAST-Prod-1",
  errorId: "b05e5062-80c6-45f5-9b0c-c2f69bb7114a",
  validationDetails: {
    "name": [
      "Name must be unique"
    ],
    "dmrLink[2]": [
      "Hostname must be provided"
    ]
  }
}

Asynchronous Operations

For long-running operations (any operation that takes longer than two seconds), a response is returned so that your application doesn't need to wait for completion.

{
  "id": "string", 
  "resourceId": "string",
  "operationType": "string",
  "createdBy": "string", 
  "createdTime": "string",
  "completedTime": "string",
  "status": "string",
  "error" : {
    "message": "string",
    "errorId": "string"
}

Where:

• id—The identifier of the operation that you can use to retrieve information about the asynchronous operation. This identifier is guaranteed to be unique for a given entity and can be in REST API to get information regarding the progress of the long-running operation.
• resourceId—The identifier of the resource being operated on.
• operationType—The description of the operation against the resource, such as create, failover, or import.
• createdBy—The identifier for the user that initialized the operation.
• createdTime—The ISO 8601-formatted date of the creation time for the operation.
• completedTime—The ISO 8601-formatted date of the completion time of the operation whether it was successful or failed.
• status—The status of the long-running operation. The states are:
  • pending—the operation is waiting to be executed and processing has not started
  • inProgress—the operation has started processing
  • succeeded—the operation has been completed successfully
  • failed—the operation failed and the error object provides details of the reason

Some REST API operations may have additional, custom states. If an error occurs (a 40x or 50x HTTP response), the following error object is returned in the response:

• error—A non-null value when the status is failed, otherwise null. When non-null, the following keys are included:
  • message—A user-friendly message describing the reason for the error or what went wrong.
  • errorId—A universally unique identifier (UUID) is useful for debugging. You can provide this code as part of the information you send to our support team.

API Rate Limiting

The number of REST APIs requests from a client session are evaluated every 30 seconds in a rolling window of five minutes. Within that five minute period, API rating limiting is applied if the rate limit is reached or exceeded. When API rating limiting is applied, your applications:

• Receive 429 error codes as responses for refused client requests.
• May experience throttling for client requests.

Solace reserves the right to adjust the rate limits at any time to ensure a high-quality service for all users of our platform. If you are subjected to rate limiting, reduce your request rate.