本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 从中获取 DICOM 实例元数据 HealthImaging
<a name="dicomweb-retrieve-instance-metadata"></a>

使用`GetDICOMInstanceMetadata`操作通过指定与资源 UIDs 关联的系列、研究和实例，从 HealthImaging [数据存储](getting-started-concepts.md#concept-data-store)中的 DICOM 实例检索元数据。除非提供了可选的图像集参数，否则 API 将仅返回主[影像集](getting-started-concepts.md#concept-image-set)中的实例元数据。通过指定为查询参数，您可以检索数据存储中的任何实例元数据（来自主影像集或非主影`imageSetId`像集）。

**获取 DICOM 实例元数据 () `.json`**  


1. 收集 HealthImaging `datastoreId`和`imageSetId`参数值。

1. 使用带有`datastoreId`和`imageSetId`参数值的[https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_GetImageSetMetadata.html](https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_GetImageSetMetadata.html)操作来检索`studyInstanceUID``seriesInstanceUID`、和的关联元数据值`sopInstanceUID`。有关更多信息，请参阅 [获取影像集元数据](get-image-set-metadata.md)。

1. 使用`datastoreId`、、、`studyInstanceUID`和的值为请求构造一个 URL `imageSetId`。`seriesInstanceUID` `sopInstanceUID`要查看以下示例中的整个 URL 路径，请滚动到 “**复制**” 按钮。网址的格式为：

   ```
   GET 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}}
   ```

1. 准备并发送您的请求。 `GetDICOMInstanceMetadata`使用带有[AWS 签名版本 4 签名](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html)协议的 HTTP GET 请求。以下代码示例使用`curl`命令行工具从 HealthImaging中获取 DICOM 实例元数据（`.json`文件）。

------
#### [ 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/metadata?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+json'
   ```

------
**注意**  
元数据中指示的传输语法 UID 与中的存储传输语法 UID (`StoredTransferSyntaxUID`) 相匹配。 HealthImaging