本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 在 HealthImaging 中搜尋 DICOM 資料
<a name="dicomweb-search"></a>

AWS HealthImaging 提供 [ DICOMweb QIDO-RS](https://www.dicomstandard.org/using/dicomweb/query-qido-rs) APIs 的表示法，以依病患 ID 搜尋研究、序列和執行個體，並接收其唯一識別符以供進一步使用。HealthImaging 的 DICOMweb QIDO-RS APIs 可讓您靈活地搜尋存放在 HealthImaging 中的資料，並提供與舊版應用程式的互通性。

**Important (重要)**  
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 是根據 Web 型醫療影像的 DICOMweb (QIDO-RS) 標準而建置。它們不會透過 AWS CLI AWS SDKs提供。

## HealthImaging 的 DICOMweb 搜尋 API APIs
<a name="dicomweb-search-services"></a>

下表說明可用於在 HealthImaging 中搜尋資料之 DICOMweb QIDO-RS APIs 的所有 HealthImaging 表示法。


**HealthImaging 表示 DICOMweb QIDO-RS APIs**  

| 名稱 | 描述 | 
| --- | --- | 
| 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 查詢類型
<a name="dicomweb-query-types"></a>

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` | 
| 標籤查詢 | 使用以群組/元素形式傳遞的查詢參數來搜尋標籤。 \$1group\$1\$1element\$1，例如 0020000D | 
| 範圍查詢 |  `...?Modality=CT&StudyDate=AABBYYYY-BBCCYYYY`  | 
| 使用 limit和 的結果分頁 offset | `.../studies?limit=1&offset=0&00080020=20000101` 您可以使用限制和位移參數來分頁搜尋回應。限制的預設值為 1000，最大值[AWS HealthImaging 端點和配額](endpoints-quotas.md)請參閱 。 最大限制 = 1000，最大位移 = 9000  | 
| 萬用字元查詢 |  萬用字元查詢可在使用 "\$1" 和 "？" 進行搜尋時提供更多彈性。"\$1" 符合任何字元序列 （包括零長度值），而 "？" 符合任何單一字元。 在資料存放區中搜尋所有研究，其中 StudyDescription 包含「Nuclear」： `.../studies?StudyDescription=*Nuclear*` 搜尋 StudyDescription 以「Nuclear」結尾的所有研究： `.../studies?StudyDescription=*Nuclear` 搜尋所有研究，其中 StudyDescription 以「Nuclear」開頭： `.../studies?StudyDescription=Nuclear*` 在 200965981 之後，搜尋 PatientID 完全有任何 3 個字元的所有研究： `.../studies?PatientID=200965981???`  | 
| FuzzyMatching 查詢 |  透過新增模糊比對選用查詢參數，在名稱 DICOM 屬性上啟用模糊比對 (PatientNamesReferringPhysicianName(0008，0090))： `.../studies?fuzzymatching=true&PatientName="Thomas^Albert"` 此查詢會對 PatientName 值的任何部分執行不區分大小寫的字首字詞比對。它會傳回具有 "thomas"、"Albert"、"Thomasberg"、"Thomas^Albert" 等 PatientName 值的結果，但不會傳回 "hom" 或 "ber"。  | 

**Topics**
+ [HealthImaging 的 DICOMweb 搜尋 API 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)