本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 從 HealthImaging 取得 DICOM 大量資料
<a name="dicom-retrieve-bulkdata"></a>

使用 `GetDICOMBulkdata`動作來擷取與 HealthImaging 資料存放區中的 DICOM 中繼資料分開的二進位資料。擷取執行個體或序列中繼資料時，大於 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. 使用表單中 的值來建構請求`BulkDataURI`的 URL：

   ```
   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 Signature 第 4 版](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html)簽署通訊協定，將`GetDICOMBulkdata`命令發出為 HTTP GET 請求。下列程式碼範例使用`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` 參數才能擷取非主要影像集的大量資料。只有在`SOPInstanceUID`指定 `datastoreId`、`studyInstanceUID`、 和 （不含 ) 時`seriesInstanceUID`，GetDICOMBulkdata 動作才會傳回主要影像集的大量資料`imagesetID`。