기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # HealthImaging에서 DICOM 데이터 검색 AWS HealthImaging은 [ DICOMweb QIDO-RS](https://www.dicomstandard.org/using/dicomweb/query-qido-rs) APIs를 표현하여 환자 ID별로 연구, 시리즈 및 인스턴스를 검색하고 추가 사용을 위해 고유 식별자를 수신합니다. HealthImaging의 DICOMweb QIDO-RS APIs HealthImaging에 저장된 데이터를 검색하고 레거시 애플리케이션과의 상호 운용성을 제공하는 방법에 유연성을 제공합니다. **중요** HealthImaging의 DICOMweb APIs 사용하여 QIDO-RS로 이미지 세트 정보를 반환할 수 있습니다. HealthImaging DICOMweb APIs 달리 명시되지 않는 한 [이미지 세트](getting-started-concepts.md#concept-image-set)만 참조합니다. HealthImaging [클라우드 네이티브 작업](https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_Operations.html) 또는 DICOMweb 작업의 선택적 이미지 세트 파라미터를 사용하여 기본이 아닌 이미지 세트를 검색합니다. HealthImaging의 DICOMweb APIs 사용하여 DICOMweb 적합성 응답과 함께 이미지 세트 정보를 반환할 수 있습니다. HealthImaging DICOMweb QIDO-RS 작업은 최대 10,000개의 레코드를 반환할 수 있습니다. 10,000개 이상의 리소스가 있는 경우 QIDO-RS 작업을 통해 검색할 수 없지만 DICOMweb WADO-RS 작업 또는 [클라우드 네이티브 작업을](https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_Operations.html) 통해 검색할 수 있습니다. 이 섹션에 나열된 APIs는 웹 기반 의료 영상에 대한 DICOMweb(QIDO-RS) 표준을 준수하도록 구축되었습니다. AWS CLI 및 AWS SDKs 통해 제공되지 않습니다. ## HealthImaging용 DICOMweb 검색 APIs 다음 표에서는 HealthImaging에서 데이터를 검색하는 데 사용할 수 있는 DICOMweb QIDO-RS APIs의 모든 HealthImaging 표현을 설명합니다. **DICOMweb QIDO-RS APIs의 HealthImaging 표현** | 이름 | 설명 | | --- | --- | | SearchDICOMStudies | GET 요청을 사용하여 검색 쿼리 요소를 지정하여 HealthImaging에서 DICOM 연구를 검색합니다. 연구 검색 결과는 마지막 업데이트, 날짜 내림차순(최신에서 가장 오래된) 순서로 JSON 형식으로 반환됩니다. [연구 검색](dicomweb-search-studies.md)을(를) 참조하세요. | | SearchDICOMSeries | GET 요청을 사용하여 검색 쿼리 요소를 지정하여 HealthImaging에서 DICOM 시리즈를 검색합니다. 시리즈 검색 결과는 JSON 형식으로 반환되며 오름차순(가장 오래된 - 최신)Series Number (0020, 0011)으로 정렬됩니다. [시리즈 검색](dicomweb-search-series.md)을(를) 참조하세요. | | SearchDICOMInstances | GET 요청을 사용하여 검색 쿼리 요소를 지정하여 HealthImaging에서 DICOM 인스턴스를 검색합니다. 인스턴스 검색 결과는 JSON 형식으로 반환되며, 오름차순(가장 오래된 - 최신)Instance Number (0020, 0013)으로 정렬됩니다. [인스턴스 검색](dicomweb-search-instances.md)을(를) 참조하세요. | ## HealthImaging에 지원되는 DICOMweb 쿼리 유형 HealthImaging은 연구, 시리즈 및 SOP 인스턴스 수준에서 QIDO-RS 계층적 리소스 쿼리를 지원합니다. HealthImaging에 QIDO-RS 계층 검색을 사용하는 경우: + 연구를 검색하면 연구 목록이 반환됩니다. + 연구 시리즈를 검색하려면 알려진가 필요하며 시리즈 목록을 `StudyInstanceUID` 반환합니다. + 인스턴스 목록을 검색하려면 알려진 `StudyInstanceUID` 및가 필요합니다. `SeriesInstanceUID` 다음 표에서는 HealthImaging에서 데이터를 검색하는 데 지원되는 QIDO-RS 계층적 쿼리 유형을 설명합니다. **HealthImaging에서 지원하는 QIDO-RS 쿼리 유형** | 쿼리 유형 | 예제 | | --- | --- | | 속성 값 쿼리 | 가 있는 연구의 모든 시리즈를 검색합니다`modality=CT`. `.../studies/1.3.6.1.4.1.14519.5.2.1.6279.6001.101370605276577556143013894866/series?00080060=CT` 환자 ID와 연구 날짜가 각각 이러한 값인 모든 연구를 검색합니다. `…/studies?PatientID=11235813&StudyDate=20130509` | | 키워드 쿼리 | `SeriesInstanceUID` 키워드를 사용하여 모든 시리즈를 검색합니다. `.../studies/1.3.6.1.4.1.14519.5.2.1.6279.6001.101370605276577556143013894866/series?SeriesInstanceUID=1.3.6.1.4.1.14519.5.2.1.6279.6001.101370605276577556143013894868` | | 쿼리 태그 지정 | 그룹/요소 양식에 전달된 쿼리 파라미터를 사용하여 태그를 검색합니다. 0020000D와 같은 \$1group\$1\$1element\$1 | | 범위 쿼리 | `...?Modality=CT&StudyDate=AABBYYYY-BBCCYYYY` | | limit 및를 사용한 결과 페이징 offset | `.../studies?limit=1&offset=0&00080020=20000101` 제한 및 오프셋 파라미터를 사용하여 검색 응답을 페이지 매김할 수 있습니다. 제한의 기본값은 1000이며 최대값은 [AWS HealthImaging 엔드포인트 및 할당량](endpoints-quotas.md) 섹션을 참조하세요. 최대 한도 = 1000, 최대 오프셋 = 9000 | | 와일드카드 쿼리 | 와일드카드 쿼리는 "\$1" 및 "?"를 사용하여 보다 유연하게 검색할 수 있습니다. "\$1"는 모든 문자 시퀀스(길이가 0인 값 포함)와 일치하고 "?"는 모든 단일 문자와 일치합니다. StudyDescription에 "Nuclear"가 포함된 데이터 스토어에서 모든 연구를 검색합니다. `.../studies?StudyDescription=*Nuclear*` StudyDescription이 "Nuclear"로 끝나는 모든 연구를 검색합니다. `.../studies?StudyDescription=*Nuclear` StudyDescription이 "Nuclear"로 시작하는 모든 연구를 검색합니다. `.../studies?StudyDescription=Nuclear*` PatientID가 200965981 뒤에 정확히 3자를 가지고 있는 모든 연구를 검색합니다. `.../studies?PatientID=200965981???` | | FuzzyMatching 쿼리 | fuzzymatching 선택적 쿼리 파라미터를 추가하여 이름 DICOM 속성(PatientName(0010,0010), ReferringPhysicianName(0008,0090))에서 퍼지 매칭을 활성화합니다. `.../studies?fuzzymatching=true&PatientName="Thomas^Albert"` 이 쿼리는 PatientName 값의 모든 부분에서 대소문자를 구분하지 않는 접두사 단어 일치를 수행합니다. "thomas", "Albert", "Thomas Albert", "Thomas^Albert"와 같은 PatientName 값으로 결과를 반환하지만 "hom" 또는 "ber"는 반환하지 않습니다. | **Topics** + [HealthImaging용 DICOMweb 검색 APIs](#dicomweb-search-services) + [HealthImaging에 지원되는 DICOMweb 쿼리 유형](#dicomweb-query-types) + [HealthImaging에서 DICOM 연구 검색](dicomweb-search-studies.md) + [HealthImaging에서 DICOM 시리즈 검색](dicomweb-search-series.md) + [HealthImaging에서 DICOM 인스턴스 검색](dicomweb-search-instances.md) # HealthImaging에서 DICOM 연구 검색 `SearchDICOMStudies` API를 사용하여 HealthImaging [데이터 스토어](getting-started-concepts.md#concept-data-store)에서 DICOM 연구를 검색합니다. 지원되는 DICOM 데이터 요소(속성)가 포함된 URL을 구성하여 HealthImaging에서 DICOM 연구를 검색할 수 있습니다. 연구 검색 결과는 마지막 업데이트, 날짜 내림차순(최신에서 가장 오래된) 순서로 JSON 형식으로 반환됩니다. **DICOM 연구를 검색하려면** 1. HealthImaging `region` 및 `datastoreId` 값을 수집합니다. 자세한 내용은 [데이터 스토어 속성 가져오기](get-data-store.md) 단원을 참조하십시오. 1. 해당하는 모든 연구 요소를 포함하여 요청에 대한 URL을 구성합니다. 다음 예제에서 전체 URL 경로를 보려면 **복사** 버튼을 스크롤합니다. URL의 형식은 다음과 같습니다. ``` GET https://dicom-medical-imaging.region.amazonaws.com/datastore/datastoreId/studies[?query] ``` **에 대한 연구 요소 `SearchDICOMStudies`** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/healthimaging/latest/devguide/dicomweb-search-studies.html) 1. 요청을 준비하고 전송합니다.는 [AWS 서명 버전 4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html) 서명 프로토콜과 함께 HTTP GET 요청을 `SearchDICOMStudies` 사용합니다. 다음 예제에서는 `curl` 명령줄 도구를 사용하여 DICOM 연구에 대한 정보를 검색합니다. ------ #### [ curl ] ``` curl --request GET \ "https://dicom-medical-imaging.us-east-1.amazonaws.com/datastore/datastoreId/studies[?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 ``` 연구 검색 결과는 마지막 업데이트, 날짜 내림차순(최신에서 가장 오래된) 순서로 JSON 형식으로 반환됩니다. ------ # HealthImaging에서 DICOM 시리즈 검색 `SearchDICOMSeries` API를 사용하여 HealthImaging [데이터 스토어](getting-started-concepts.md#concept-data-store)에서 DICOM 시리즈를 검색합니다. 지원되는 DICOM 데이터 요소(속성)가 포함된 URL을 구성하여 HealthImaging에서 DICOM 시리즈를 검색할 수 있습니다. 시리즈 검색 결과는 오름차순(가장 오래된\$1최신)으로 정렬된 JSON 형식으로 반환됩니다. **DICOM 시리즈를 검색하려면** 1. HealthImaging `region` 및 `datastoreId` 값을 수집합니다. 자세한 내용은 [데이터 스토어 속성 가져오기](get-data-store.md) 단원을 참조하십시오. 1. `StudyInstanceUID` 값을 수집합니다. 자세한 내용은 [이미지 세트 메타데이터 가져오기](get-image-set-metadata.md) 단원을 참조하십시오. 1. 적용 가능한 모든 시리즈 요소를 포함하여 요청에 대한 URL을 구성합니다. 다음 예제에서 전체 URL 경로를 보려면 **복사** 버튼을 스크롤합니다. URL의 형식은 다음과 같습니다. ``` GET https://dicom-medical-imaging.region.amazonaws.com/datastore/datastoreId/studies/StudyInstanceUID/series[?query] ``` **에 대한 시리즈 요소 `SearchDICOMSeries`** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/healthimaging/latest/devguide/dicomweb-search-series.html) 1. 요청을 준비하고 전송합니다.는 [AWS 서명 버전 4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html) 서명 프로토콜과 함께 HTTP GET 요청을 `SearchDICOMSeries` 사용합니다. 다음 예제에서는 `curl` 명령줄 도구를 사용하여 DICOM 시리즈 정보를 검색합니다. ------ #### [ curl ] ``` curl --request GET \ "https://dicom-medical-imaging.us-east-1.amazonaws.com/datastore/datastoreId/studies/StudyInstanceUID/series[?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 ``` 시리즈 검색 결과는 JSON 형식으로 반환되며 오름차순(가장 오래된 - 최신)`Series Number (0020,0011)`으로 정렬됩니다. ------ # HealthImaging에서 DICOM 인스턴스 검색 `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 형식으로 반환됩니다. ------