Getting a DICOM instance from HealthImaging

Use the GetDICOMInstance action to retrieve a DICOM instance (.dcm file) from a HealthImaging data store by specifying the Series, Study, and Instance UIDs associated with the resource. You can specify the image set from which an instance resource should be retrieved by providing the image set ID as a query parameter. In addition, you can choose the transfer syntax to compress the DICOM data, with support for uncompressed (ELE) or High-Throughput JPEG 2000 (HTJ2K).

Note

With GetDICOMInstance, you can interoperate with systems that utilize DICOM Part 10 binaries while simultaneously taking advantage of HealthImaging’s cloud native actions.

To get a DICOM instance (.dcm)

1. Collect HealthImaging datastoreId and imageSetId parameter values.

2. Use the GetImageSetMetadata action with the datastoreId and imageSetId parameter values to retrieve associated metadata values for studyInstanceUID, seriesInstanceUID, and sopInstanceUID. For more information, see Getting image set metadata.

3. Construct a URL for the request using the values for datastoreId, studyInstanceUID, seriesInstanceUID, sopInstanceUID, and imageSetId. To view the entire URL path in the following example, scroll over the Copy button. The URL is of the form:

   https://dicom-medical-imaging.region.amazonaws.com/datastore/datastore-id/studies/study-instance-uid/series/series-instance-uid/instances/sop-instance-uid?imageSetId=image-set-id
   

4. Prepare and send your request. GetDICOMInstance uses a HTTP GET request with AWS Signature Version 4 signing protocol. The following code example uses the curl command line tool to get a DICOM instance (.dcm file) from HealthImaging.

   Shell

   curl --request GET \
     'https://dicom-medical-imaging.us-east-1.amazonaws.com/datastore/d9a2a515ab294163a2d2f4069eed584c/studies/1.3.6.1.4.1.5962.1.2.4.20040826285059.5457/series/1.3.6.1.4.1.5962.1.3.4.1.20040825185059.5457/instances/1.3.6.1.4.1.5962.1.1.4.1.1.20040826186059.5457?imageSetId=459e50687f121185f747b67bb60d1bc8' \
     --aws-sigv4 'aws:amz:us-east-1:medical-imaging' \
     --user "$AWS_ACCESS_KEY_ID:$AWS_SECRET_ACCESS_KEY" \
     --header "x-amz-security-token:$AWS_SESSION_TOKEN" \
     --header 'Accept: application/dicom; transfer-syntax=1.2.840.10008.1.2.1' \
     --output 'dicom-instance.dcm'
   

   Note

   The transfer-syntax UID is optional and defaults to Explicit VR Little Endian if not included. Supported transfer syntaxes include:

   • Explicit VR Little Endian (ELE) - 1.2.840.10008.1.2.1 (default)

   • High-Throughput JPEG 2000 with RPCL Options Image Compression (Lossless Only) - 1.2.840.10008.1.2.4.202

     For more information, see HTJ2K decoding libraries for AWS HealthImaging.