Getting DICOM instance metadata from HealthImaging
Use the GetDICOMInstanceMetadata
action to retrieve the metadata from a DICOM instance in a HealthImaging
data store by specifying the Series, Study, and Instance UIDs associated with the resource. You can specify the
image set from which instance resource metadata should be retrieved by providing the image set ID as a query parameter.
Note
With GetDICOMInstanceMetadata
, you can interoperate with systems that utilize DICOM Part 10 binaries
while simultaneously taking advantage of HealthImaging’s cloud native actions.
To get DICOM instance metadata (.json
)
-
Collect HealthImaging
datastoreId
andimageSetId
parameter values. -
Use the
GetImageSetMetadata
action with thedatastoreId
andimageSetId
parameter values to retrieve associated metadata values forstudyInstanceUID
,seriesInstanceUID
, andsopInstanceUID
. For more information, see Getting image set metadata. -
Construct a URL for the request using the values for
datastoreId
,studyInstanceUID
,seriesInstanceUID
,sopInstanceUID
, andimageSetId
. 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
/metadata?imageSetId=image-set-id
-
Prepare and send your request.
GetDICOMInstanceMetadata
uses a HTTP GET request with AWS Signature Version 4 signing protocol. The following code example uses thecurl
command line tool to get DICOM instance metadata (.json
file) from HealthImaging.