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

# 从中获取 DICOM 批量数据 HealthImaging
<a name="dicom-retrieve-bulkdata"></a>

使用`GetDICOMBulkdata`操作检索已在数据存储中与 DICOM 元数据分离的二进制 HealthImaging 数据。检索实例或系列元数据时，大于 1MB 的二进制属性将由`BulkDataURI`而不是内联值表示。您可以使用元数据响应中`BulkDataURI`提供的来检索 HealthImaging 数据存储中任何主影像集的二进制数据。您可以通过提供影像集 ID 作为查询参数来检索非主影像集的批量数据。

**获取 DICOM 批量数据**  


当您从 HealthImaging DICOMweb WADO-RS 操作中检索 DICOM 元数据（例如`GetDICOMInstanceMetadata`或）时`GetDICOMSeriesMetadata`，大型二进制属性将按顺序替换为，如下所示： BulkDataURIs

```
"00451026": {
    "vr": "UN",
    "BulkDataURI": "https://dicom-medical-imaging.us-west-2.amazonaws.com/datastore/<datastoreId>/studies/<StudyInstanceUID>/series/<SeriesInstanceUID>/instances/<SOPInstanceUID>/bulkdata/<bulkdataUriHash>"
}
```

要使用`GetDICOMBulkdata`操作检索 DICOM 元素，请使用以下步骤。

1. 使用以下格式的值为请求构造一个 URL：`BulkDataURI`

   ```
   https://dicom-medical-imaging.region.amazonaws.com/datastore/datastore-id/studies/study-instance-uid/series/series-instance-uid/instances/sop-instance-uid/bulkdata/bulkdata-uri-hash
   ```

1. 使用 [AWS 签名版本 4 签名](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html)协议以 HTTP GET 请求的形式发出您的`GetDICOMBulkdata`命令。以下代码示例使用`curl`命令行工具从主影像集中检索 DICOM 元素：

   ```
   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.2.840.10008.5.1.4.1.1.7/bulkdata/b026324c6904b2a9cb4b88d6d61c81d1' \
     --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/octet-stream' \
     --output 'bulkdata.bin'
   ```

   要从非主影像集中检索 DICOM 数据元素，请提供一个`ImageSetId`参数：

   ```
   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.2.840.10008.5.1.4.1.1.7/bulkdata/b026324c6904b2a9cb4b88d6d61c81d1?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/octet-stream' \
     --output 'bulkdata.bin'
   ```

**注意**  
该`imageSetId`参数是检索非主影像集的批量数据所必需的。仅当指定了`datastoreId`、`studyInstanceUID`、和（不带）时，“获取” DICOMBulkdata 操作才会返回主影像集`SOPInstanceUID`的批量数据。`seriesInstanceUID` `imagesetID`