기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # HealthImaging에서 DICOM 데이터 검색 AWS HealthImaging은 시리즈 및 인스턴스 수준에서 데이터를 검색하기 위한 [https://www.dicomstandard.org/using/dicomweb/retrieve-wado-rs-and-wado-uri](https://www.dicomstandard.org/using/dicomweb/retrieve-wado-rs-and-wado-uri) APIs 표현을 제공합니다. 이러한 APIs 사용하면 HealthImaging [데이터 스토어](getting-started-concepts.md#concept-data-store)에서 DICOM 시리즈의 모든 메타데이터를 검색할 수 있습니다. DICOM 인스턴스, DICOM 인스턴스 메타데이터 및 DICOM 인스턴스 프레임(픽셀 데이터)을 검색할 수도 있습니다. HealthImaging의 `DICOMweb WADO-RS` APIs HealthImaging에 저장된 데이터를 검색하고 레거시 애플리케이션과의 상호 운용성을 제공하는 방법에 유연성을 제공합니다. **중요** HealthImaging은 DICOM 데이터를 [이미지 세트](getting-started-concepts.md#concept-image-set)로 저장합니다. HealthImaging [클라우드 네이티브 작업을](https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_Operations.html) 사용하여 이미지 세트를 관리하고 검색합니다. HealthImaging의 DICOMweb APIs 사용하여 DICOMweb 적합성 응답과 함께 이미지 세트 정보를 반환할 수 있습니다. 이 섹션에 나열된 APIs는 웹 기반 의료 영상에 대한 DICOMweb(WADO-RS) 표준을 준수하도록 구축되었습니다. DICOMweb APIs의 표현이므로 AWS CLI 및 AWS SDKs 통해 제공되지 않습니다. 다음 표에서는 HealthImaging에서 데이터를 검색하는 데 사용할 수 있는 DICOMweb WADO-RS APIs의 모든 HealthImaging 표현을 설명합니다. **DICOMweb WADO-RS APIs의 HealthImaging 표현** | 이름 | 설명 | | --- | --- | | GetDICOMSeriesMetadata | 리소스와 연결된 연구 및 시리즈 UIDs를 지정하여 HealthImaging 데이터 스토어에서 DICOM 시리즈에 대한 DICOM 인스턴스 메타데이터(.json 파일)를 검색합니다. [시리즈 메타데이터 검색](dicomweb-retrieve-series-metadata.md)을(를) 참조하세요. | | GetDICOMInstance | 리소스와 연결된 시리즈, 연구 및 인스턴스 UIDs를 지정하여 HealthImaging 데이터 스토어에서 DICOM 인스턴스(.dcm 파일)를 검색합니다. [인스턴스 검색](dicomweb-retrieve-instance.md)을(를) 참조하세요. | | GetDICOMInstanceMetadata | 리소스와 연결된 시리즈, 연구 및 인스턴스 UIDs를 지정하여 HealthImaging 데이터 스토어의 DICOM 인스턴스에서 DICOM 인스턴스 메타데이터(.json 파일)를 검색합니다. [인스턴스 메타데이터 검색](dicomweb-retrieve-instance-metadata.md)을(를) 참조하세요. | | GetDICOMInstanceFrames | 리소스와 연결된 시리즈 UID, 연구 UID, 인스턴스 UID UIDs 및 프레임 번호를 지정하여 HealthImaging 데이터 스토어의 DICOM 인스턴스에서 단일 또는 배치 이미지 프레임(multipart 요청)을 검색합니다. [프레임 검색](dicomweb-retrieve-instance-frames.md)을(를) 참조하세요. | **Topics** + [HealthImaging에서 DICOM 인스턴스 가져오기](dicomweb-retrieve-instance.md) + [HealthImaging에서 DICOM 인스턴스 메타데이터 가져오기](dicomweb-retrieve-instance-metadata.md) + [HealthImaging에서 DICOM 시리즈 메타데이터 가져오기](dicomweb-retrieve-series-metadata.md) + [HealthImaging에서 DICOM 인스턴스 프레임 가져오기](dicomweb-retrieve-instance-frames.md) + [HealthImaging에서 DICOM 대량 데이터 가져오기](dicom-retrieve-bulkdata.md) # HealthImaging에서 DICOM 인스턴스 가져오기 `GetDICOMInstance` 작업을 사용하여 리소스와 연결된 시리즈, 연구 및 인스턴스 UIDs를 지정하여 HealthImaging [데이터 스토어](getting-started-concepts.md#concept-data-store)에서 DICOM 인스턴스(`.dcm` 파일)를 검색합니다. API는 선택적 이미지 세트 [파라미터가 제공되지 않는 한 기본 이미지 세트](getting-started-concepts.md#concept-image-set)의 인스턴스만 반환합니다. 를 쿼리 파라미터`imageSetId`로 지정하여 데이터 스토어의 모든 인스턴스(기본 또는 비기본 이미지 세트에서)를 검색할 수 있습니다. DICOM 데이터는 저장된 전송 구문 또는 비압축(ELE) 형식으로 검색할 수 있습니다. **DICOM 인스턴스를 가져오려면(`.dcm`)** 1. HealthImaging `datastoreId` 및 `imageSetId` 파라미터 값을 수집합니다. 1. [https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_GetImageSetMetadata.html](https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_GetImageSetMetadata.html) 작업을 `datastoreId` 및 `imageSetId` 파라미터 값과 함께 사용하여 `studyInstanceUID`, `seriesInstanceUID`및에 연결된 메타데이터 값을 검색합니다`sopInstanceUID`. 자세한 내용은 [이미지 세트 메타데이터 가져오기](get-image-set-metadata.md) 단원을 참조하십시오. 1. , `datastoreId`, `studyInstanceUID`, 및 값을 사용하여 요청에 대한 URL을 구성합니다`seriesInstanceUID``sopInstanceUID``imageSetId`. 다음 예제에서 전체 URL 경로를 보려면 **복사** 버튼을 스크롤합니다. URL의 형식은 다음과 같습니다. ``` GET https://dicom-medical-imaging.region.amazonaws.com/datastore/datastore-id/studies/study-instance-uid/series/series-instance-uid/instances/sop-instance-uid?imageSetId=image-set-id ``` 1. 요청을 준비하고 전송합니다.는 [AWS 서명 버전 4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html) 서명 프로토콜과 함께 HTTP GET 요청을 `GetDICOMInstance` 사용합니다. 다음 코드 예제에서는 `curl` 명령줄 도구를 사용하여 HealthImaging에서 DICOM 인스턴스(`.dcm` 파일)를 가져옵니다. ------ #### [ 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?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; transfer-syntax=1.2.840.10008.1.2.1' \ --output 'dicom-instance.dcm' ``` ------ **참고** `transfer-syntax` UID는 선택 사항이며 포함되지 않은 경우 기본적으로 Explicit VR Little Endian으로 설정됩니다. 지원되는 전송 구문은 다음과 같습니다. 명시적 VR 리틀 엔디안(ELE) - `1.2.840.10008.1.2.1` (무손실 이미지 프레임의 기본값) 이 `transfer-syntax=*` 경우 이미지 프레임(들)이 저장된 전송 구문으로 반환됩니다. RPCL 옵션 이미지 압축을 사용하는 High-Throughput JPEG 2000(Lossless Only) `1.2.840.10008.1.2.4.202` - 인스턴스가 HealthImaging에 로 저장된 경우 `1.2.840.10008.1.2.4.202` JPEG 2000 무손실 `1.2.840.10008.1.2.4.90` - 인스턴스가 HealthImaging에 무손실로 저장된 경우. JPEG 기준(프로세스 1): 손실된 JPEG 8비트 이미지 압축에 대한 기본 전송 구문 `1.2.840.10008.1.2.4.50`- 인스턴스가 HealthImaging에 로 저장된 경우 `1.2.840.10008.1.2.4.50` JPEG 2000 이미지 압축 `1.2.840.10008.1.2.4.91`- 인스턴스가 HealthImaging에 로 저장된 경우 `1.2.840.10008.1.2.4.91` High-Throughput JPEG 2000 Image Compression `1.2.840.10008.1.2.4.203` - 인스턴스가 HealthImaging에 로 저장된 경우 `1.2.840.10008.1.2.4.203` JPEG XL 이미지 압축 - 인스턴스가 HealthImaging에 로 저장된 `1.2.840.10008.1.2.4.112` 경우 `1.2.840.10008.1.2.4.112` [전송 구문](supported-transfer-syntaxes.md)의 MPEG 패밀리(MPEG2, MPEG-4 AVC/H.264 및 HEVC/H.265 포함)에 인코딩된 하나 이상의 이미지 프레임이 있는 HealthImaging에 저장된 인스턴스는 해당 전송 구문 UID로 검색할 수 있습니다. 예를 들어 인스턴스가 MPEG2 기본 프로필 기본 레벨로 저장된 `1.2.840.10008.1.2.4.100` 경우입니다. 자세한 내용은 [지원되는 전송 구문](supported-transfer-syntaxes.md) 및 [AWS HealthImaging용 이미지 프레임 디코딩 라이브러리](reference-libraries.md) 섹션을 참조하세요. # HealthImaging에서 DICOM 인스턴스 메타데이터 가져오기 `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. [https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_GetImageSetMetadata.html](https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_GetImageSetMetadata.html) 작업을 `datastoreId` 및 `imageSetId` 파라미터 값과 함께 사용하여 `studyInstanceUID`, `seriesInstanceUID`및에 연결된 메타데이터 값을 검색합니다`sopInstanceUID`. 자세한 내용은 [이미지 세트 메타데이터 가져오기](get-image-set-metadata.md) 단원을 참조하십시오. 1. , `datastoreId`, `studyInstanceUID`, 및 값을 사용하여 요청에 대한 URL을 구성합니다`seriesInstanceUID``sopInstanceUID``imageSetId`. 다음 예제에서 전체 URL 경로를 보려면 **복사** 버튼을 스크롤합니다. 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. 요청을 준비하고 전송합니다.는 [AWS 서명 버전 4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html) 서명 프로토콜과 함께 HTTP GET 요청을 `GetDICOMInstanceMetadata` 사용합니다. 다음 코드 예제에서는 `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는 HealthImaging의 저장된 전송 구문 UID(`StoredTransferSyntaxUID`)와 일치합니다. # HealthImaging에서 DICOM 시리즈 메타데이터 가져오기 `GetDICOMSeriesMetadata` 작업을 사용하여 HealthImaging [데이터 스토어](getting-started-concepts.md#concept-data-store)에서 DICOM 시리즈(`.json` 파일)의 메타데이터를 검색합니다. 리소스와 연결된 연구 및 시리즈 UIDs를 지정하여 HealthImaging 데이터 스토어의 모든 기본 [ 이미지 세트](getting-started-concepts.md#concept-image-set)에 대한 시리즈 메타데이터를 검색할 수 있습니다. 이미지 세트 ID를 쿼리 파라미터로 제공하여 기본이 아닌 이미지 세트에 대한 시리즈 메타데이터를 검색할 수 있습니다. 시리즈 메타데이터는 `DICOM JSON` 형식으로 반환됩니다. **DICOM 시리즈 메타데이터를 가져오려면(`.json`)** 1. HealthImaging `datastoreId` 및 `imageSetId` 파라미터 값을 수집합니다. 1. `datastoreId`, `studyInstanceUID`, `seriesInstanceUID`및 선택적으로 값을 사용하여 요청에 대한 URL을 구성합니다`imageSetId`. 다음 예제에서 전체 URL 경로를 보려면 **복사** 버튼을 스크롤합니다. URL의 형식은 다음과 같습니다. ``` GET https://dicom-medical-imaging.region.amazonaws.com/datastore/datastore-id/studies/study-instance-uid/series/series-instance-uid/metadata ``` 1. 요청을 준비하고 전송합니다.는 [AWS 서명 버전 4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html) 서명 프로토콜과 함께 HTTP GET 요청을 `GetDICOMSeriesMetadata` 사용합니다. 다음 코드 예제에서는 `curl` 명령줄 도구를 사용하여 HealthImaging에서 메타데이터(`.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/metadata \ --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' \ --output 'series-metadata.json' ``` ------ 선택적 `imageSetId` 파라미터를 사용합니다. ------ #### [ 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/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' \ --output 'series-metadata.json' ``` ------ **참고** `imageSetId` 파라미터는 기본이 아닌 이미지 세트에 대한 시리즈 메타데이터를 검색하는 데 필요합니다. `GetDICOMInstanceMetadata` 작업은 `datastoreId`, `studyInstanceUID`가 지정된 경우에만 기본 이미지 세트에 대한 시리즈 메타데이터를 반환`seriesInstanceUID`합니다( 제외`imagesetID`). # HealthImaging에서 DICOM 인스턴스 프레임 가져오기 `GetDICOMInstanceFrames` 작업을 사용하여 리소스와 연결된 시리즈 UID, 연구 UID, 인스턴스 UIDs 및 프레임 번호를 지정하여 HealthImaging [데이터 스토어](getting-started-concepts.md#concept-data-store)의 DICOM 인스턴스에서 단일 또는 배치 이미지 프레임(`multipart` 요청)을 검색합니다. [이미지 세트](getting-started-concepts.md#concept-image-set) ID를 쿼리 파라미터로 제공하여 인스턴스 프레임을 검색할 이미지 세트를 지정할 수 있습니다. API는 선택적 이미지 세트 파라미터가 제공되지 않는 한 기본 [이미지 세트](getting-started-concepts.md#concept-image-set)의 인스턴스 프레임만 반환합니다. 를 쿼리 파라미터`imageSetId`로 지정하여 데이터 스토어의 모든 인스턴스 프레임(기본 또는 비기본 이미지 세트에서)을 검색할 수 있습니다. DICOM 데이터는 저장된 전송 구문 또는 비압축(ELE) 형식으로 검색할 수 있습니다. **DICOM 인스턴스 프레임을 가져오려면(`multipart`)** 1. HealthImaging `datastoreId` 및 `imageSetId` 파라미터 값을 수집합니다. 1. [https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_GetImageSetMetadata.html](https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_GetImageSetMetadata.html) 작업을 `datastoreId` 및 `imageSetId` 파라미터 값과 함께 사용하여 `studyInstanceUID`, `seriesInstanceUID`및에 연결된 메타데이터 값을 검색합니다`sopInstanceUID`. 자세한 내용은 [이미지 세트 메타데이터 가져오기](get-image-set-metadata.md) 단원을 참조하십시오. 1. 연결된 메타데이터에서 검색할 이미지 프레임을 결정하여 `frameList` 파라미터를 형성합니다. `frameList` 파라미터는 임의의 순서로 하나 이상의 중복되지 않은 프레임 번호를 쉼표로 구분한 목록입니다. 예를 들어 메타데이터의 첫 번째 이미지 프레임은 프레임 1입니다. + 단일 프레임 요청: `/frames/1` + 다중 프레임 요청: `/frames/1,2,3,4` 1. , `datastoreId`, , `studyInstanceUID`, 및 값을 사용하여 요청에 대한 URL을 구성합니다`seriesInstanceUID``sopInstanceUID``imageSetId``frameList`. 다음 예제에서 전체 URL 경로를 보려면 **복사** 버튼을 스크롤합니다. URL의 형식은 다음과 같습니다. ``` GET https://dicom-medical-imaging.region.amazonaws.com/datastore/datastore-id/studies/study-instance-uid/series/series-instance-uid/instances/sop-instance-uid/frames/1?imageSetId=image-set-id ``` 1. 요청을 준비하고 전송합니다.는 [AWS 서명 버전 4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html) 서명 프로토콜과 함께 HTTP GET 요청을 `GetDICOMInstanceFrames` 사용합니다. 다음 코드 예제에서는 `curl` 명령줄 도구를 사용하여 HealthImaging의 `multipart` 응답으로 이미지 프레임을 가져옵니다. ------ #### [ 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/frames/1?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: multipart/related; type=application/octet-stream; transfer-syntax=1.2.840.10008.1.2.1' ``` ------ **참고** `transfer-syntax` UID는 선택 사항이며 포함되지 않은 경우 기본적으로 Explicit VR Little Endian으로 설정됩니다. ELE로의 트랜스코딩이 불가능한 경우(경고와 함께 가져오기 때문에) 트랜스코딩 없이 픽셀이 반환됩니다. 지원되는 전송 구문은 다음과 같습니다. 명시적 VR 리틀 엔디안(ELE) - `1.2.840.10008.1.2.1` (무손실 이미지 프레임의 기본값) `transfer-syntax=*` 그러면 이미지 프레임(들)이 저장된 전송 구문으로 반환됩니다. RPCL 옵션 이미지 압축을 사용하는 High-Throughput JPEG 2000(Lossless Only) `1.2.840.10008.1.2.4.202` - 인스턴스가 HealthImaging에 로 저장된 경우 `1.2.840.10008.1.2.4.202` JPEG 2000 무손실 `1.2.840.10008.1.2.4.90` - 인스턴스가 HealthImaging에 무손실로 저장된 경우. JPEG 기준(프로세스 1): 손실된 JPEG 8비트 이미지 압축에 대한 기본 전송 구문 `1.2.840.10008.1.2.4.50`- 인스턴스가 HealthImaging에 로 저장된 경우 `1.2.840.10008.1.2.4.50` JPEG 2000 이미지 압축 - 인스턴스가 HealthImaging에 로 저장된 `1.2.840.10008.1.2.4.91` 경우 `1.2.840.10008.1.2.4.91` High-Throughput JPEG 2000 Image Compression `1.2.840.10008.1.2.4.203`- 인스턴스가 HealthImaging에 로 저장된 경우 `1.2.840.10008.1.2.4.203` JPEG XL 이미지 압축 - 인스턴스가 HealthImaging에 로 저장된 `1.2.840.10008.1.2.4.112` 경우 `1.2.840.10008.1.2.4.112` [전송 구문](supported-transfer-syntaxes.md)의 MPEG 패밀리(MPEG2, MPEG-4 AVC/H.264 및 HEVC/H.265 포함)에 인코딩된 하나 이상의 이미지 프레임이 있는 HealthImaging에 저장된 인스턴스는 해당 전송 구문 UID로 검색할 수 있습니다. 예를 들어 인스턴스가 MPEG2 기본 프로필 기본 레벨로 저장된 `1.2.840.10008.1.2.4.100` 경우입니다. 저장된 전송 구문`NotAcceptableException`을 기반으로 요청된 전송 구문을 반환할 수 없거나 인스턴스에 대한 특정 처리 경고가 있는 경우 406을 받을 수 있습니다. 이 경우를 사용하여 호출을 다시 시도합니다`transfer-syntax=*`. 자세한 내용은 [지원되는 전송 구문](supported-transfer-syntaxes.md) 및 [AWS HealthImaging용 이미지 프레임 디코딩 라이브러리](reference-libraries.md) 섹션을 참조하세요. # HealthImaging에서 DICOM 대량 데이터 가져오기 `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//studies//series//instances//bulkdata/" } ``` `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`).