기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# HealthImaging에서 DICOM 대량 데이터 가져오기
<a name="dicom-retrieve-bulkdata"></a>

`GetDICOMBulkdata` 작업을 사용하여 HealthImaging 데이터 스토어의 DICOM 메타데이터와 분리된 이진 데이터를 검색합니다. 인스턴스 또는 시리즈 메타데이터를 검색할 때 1MB보다 큰 이진 속성은 인라인 값 `BulkDataURI` 대신 로 표시됩니다. 메타데이터 응답에 `BulkDataURI` 제공된를 사용하여 HealthImaging 데이터 스토어의 모든 기본 이미지 세트에 대한 바이너리 데이터를 검색할 수 있습니다. 이미지 세트 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. 양식의의 값을 사용하여 요청에 대한 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) 서명 프로토콜을 사용하여 `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`).