DICOM PS3.18 2019a - Web Services

6.9.7.3 Response

6.9.7.3.1 Response Status Line

The Service shall return an HTTP status line, including a status code and associated reason phrase.

If the CreateSubscription request was successful, the Service shall return an "HTTP 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.

Table 6.9.7-2. Status Codes

HTTP 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.


DICOM PS3.18 2019a - Web Services