

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

# HealthImaging에서 DICOM 인스턴스 검색
<a name="dicomweb-search-instances"></a>

`SearchDICOMInstances` API를 사용하여 HealthImaging [데이터 스토어](getting-started-concepts.md#concept-data-store)에서 DICOM 인스턴스를 검색합니다. 지원되는 DICOM 데이터 요소(속성)가 포함된 URL을 구성하여 HealthImaging에서 DICOM 인스턴스를 검색할 수 있습니다. 인스턴스 결과는 JSON 형식으로 반환되며 오름차순(가장 오래됨\$1최신)으로 정렬됩니다.

**DICOM 인스턴스를 검색하려면**  


1. HealthImaging `region` 및 `datastoreId` 값을 수집합니다. 자세한 내용은 [데이터 스토어 속성 가져오기](get-data-store.md) 단원을 참조하십시오.

1. `StudyInstanceUID` 및에 대한 값을 수집합니다`SeriesInstanceUID`. 자세한 내용은 [이미지 세트 메타데이터 가져오기](get-image-set-metadata.md) 단원을 참조하십시오.

1. 해당하는 모든 검색 요소를 포함하여 요청에 대한 URL을 구성합니다. 다음 예제에서 전체 URL 경로를 보려면 **복사** 버튼을 스크롤합니다. URL의 형식은 다음과 같습니다.

   ```
   GET https://dicom-medical-imaging.region.amazonaws.com/datastore/datastoreId/studies/StudyInstanceUID/series/SeriesInstanceUID/instances[?query]
   ```  
**에 대한 인스턴스 요소 `SearchDICOMInstances`**    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/healthimaging/latest/devguide/dicomweb-search-instances.html)

   HealthImaging은 DICOM 요소[(0008,1196)](https://dicom.nema.org/dicom/2013/output/chtml/part18/sect_6.6.html#sect_6.6.1.3.2.1.1)를 사용하여 가져오기 경고 코드를 유지합니다. 인스턴스 수준에서 가져오기 경고 코드를 검색할 수 있습니다. 와일드카드 또는 특정 경고 코드로 가져오기 경고 코드를 검색할 수 있습니다. [HealthImaging 경고 코드](reference-warning-codes.md)을(를) 참조하세요.

1. 요청을 준비하고 전송합니다.는 [AWS 서명 버전 4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html) 서명 프로토콜과 함께 HTTP GET 요청을 `SearchDICOMInstances` 사용합니다. 다음 예제에서는 `curl` 명령줄 도구를 사용하여 DICOM 인스턴스에 대한 정보를 검색합니다.

------
#### [ curl ]

   ```
   curl --request GET \
     "https://dicom-medical-imaging.us-east-1.amazonaws.com/datastore/datastoreId/studies/StudyInstanceUID/series/SeriesInstanceUID/instances[?query]"
     --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 results.json
   ```

   인스턴스 검색 결과는 오름차순(가장 오래된 - 최신)`Instance Number (0020,0013)`으로 정렬된 JSON 형식으로 반환됩니다.

------