The Service shall return an HTTP/1.1 status line, including a status code and associated reason phrase.
If the CreateSubscription request was successful, the Service shall return an "HTTP/1.1 201 - Created" response code. The response shall contain a "Content-Location" header of the following format:
Content-Location: {WSSERVICE}
where:
- {WSSERVICE}is the base URL for the WebSocket service. This shall include the WebSocket protocol (either WS or WSS) and may include a combination of authority and path.
If the subscription fails, the Service shall return an appropriate failure status line with a response code from Table 6.9.7-2, “Status Codes”.
Table 6.9.7-2. Status Codes
|
HTTP/1.1 Code |
Reason Phrase |
Description |
|---|---|---|
|
201 |
Created |
The subscription was created. |
|
400 |
Bad Request |
The UPS-RS Origin-Server was unable to understand the request |
|
401 |
Unauthorized |
The UPS-RS Origin-Server refused to accept the request because the client is not authenticated. |
|
403 |
Forbidden |
The UPS-RS Origin-Server understood the request, but is refusing to perform the query (e.g., the Origin-Server does not support global subscription filtering or an authenticated user has insufficient privileges). |
|
404 |
Not found |
The specified UPS Instance or well-known UID does not exist or is not managed by this Origin-Server. |
|
409 |
Conflict |
Specified action not appropriate for specified instance. |
|
503 |
Busy |
Service is unavailable. |