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

# HealthImaging에서 DICOM 인스턴스 메타데이터 가져오기
<a name="dicomweb-retrieve-instance-metadata"></a>

`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`)와 일치합니다.