翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# HealthImaging からの DICOM バルクデータの取得
<a name="dicom-retrieve-bulkdata"></a>

`GetDICOMBulkdata` アクションを使用して、HealthImaging データストアの DICOM メタデータから分離されたバイナリデータを取得します。インスタンスまたはシリーズのメタデータを取得する場合、1MB を超えるバイナリ属性はインライン値`BulkDataURI`ではなく で表されます。HealthImaging データストア内の任意のプライマリイメージセットのバイナリデータを取得するには、メタデータレスポンスで`BulkDataURI`提供される を使用します。非プライマリイメージセットのバルクデータを取得するには、イメージセット ID をクエリパラメータとして指定します。

**DICOM バルクデータを取得するには**  


`GetDICOMInstanceMetadata` や などの HealthImaging DICOMweb WADO-RS アクションから DICOM メタデータを取得すると、次に示すように`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 署名バージョン 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` パラメータは、プライマリ以外のイメージセットのバルクデータを取得するために必要です。GetDICOMBulkdata アクションは、、`datastoreId`、`studyInstanceUID`、`seriesInstanceUID`および `SOPInstanceUID`が指定されている場合にのみ、プライマリイメージセットのバルクデータを返します ( なし`imagesetID`)。