DICOM PS3.18 2019a - Web Services
6.9.7 CreateSubscription (Current)
Prev  6.9 UPS-RS Worklist Service  Next
PS3.18 > DICOM Communication Model for Web Services > UPS-RS Worklist Service > CreateSubscription

6.9.7 CreateSubscription

This resource records subscribers to whom future events associated with the specified UPS Instances will be reported.

6.9.7.1 Request

The request message shall be formed as follows:

  • Resource

    • {+SERVICE}/workitems/{UPSInstanceUID}/subscribers/{AETitle}}{?deletionlock}

    • {+SERVICE}/workitems/1.2.840.10008.5.1.4.34.5/subscribers/{AETitle}{?deletionlock}

    • {+SERVICE}/workitems/1.2.840.10008.5.1.4.34.5.1/subscribers/{AETitle}{?deletionlock,query*}

      where

      • {+SERVICE} is the base URL for the service. This may be a combination of protocol (either HTTP or HTTPS), authority and path.

      • {UPSInstanceUID} is the UID of the Unified Procedure Step Instance or a well-known UID

      • {AETitle} is an Application Entity Title that conforms to the "AE" Value Representation (see Table 6.2-1 in PS3.5 ) and identifies the Application Entity to be subscribed

      • {deletionlock}, if present, shall have a value of either "true" or "false", indicating whether or not the User-Agent is requesting a Deletion Lock

      • {query} specifies the query key/value pairs describing the filter parameters

  • Method

    • POST

  • Headers

    • Content-Length: 0

  • {query}

    • deletionlock=true | false

    • {attributeID}={value}

      0-n / {attributeID}={value} pairs allowed

      Each {attributeID} shall refer to an attribute of the Unified Procedure Step IOD (see Section B.26.2 in PS3.3 ).

      See Section 6.7.1.1 for {attributeID} and {value} encoding rules.

  • The request body shall be empty.

Prev  Up  Next
6.9.5.2.3 Response Message Body  Home  6.9.7.2 Behavior
DICOM PS3.18 2019a - Web Services