기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # 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) 섹션을 참조하세요.