本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 在 HealthImaging 中搜尋 DICOM 資料 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 下表說明可用於在 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 查詢類型 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) # 在 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/zh_tw/healthimaging/latest/devguide/dicomweb-search-studies.html) 1. 準備並傳送您的請求。 `SearchDICOMStudies`使用 HTTP GET 請求搭配 [AWS Signature 第 4 版](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html)簽署通訊協定。下列範例使用`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 系列。系列搜尋結果會以 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/zh_tw/healthimaging/latest/devguide/dicomweb-search-series.html) 1. 準備並傳送您的請求。 `SearchDICOMSeries`使用 HTTP GET 請求搭配 [AWS Signature 第 4 版](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html)簽署通訊協定。下列範例使用`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 格式傳回，依遞增排序 （最舊到最新）。 **搜尋 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/zh_tw/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. 準備並傳送您的請求。 `SearchDICOMInstances`使用具有 [AWS Signature 第 4 版簽署通訊協定的 HTTP GET ](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html)請求。下列範例使用`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 ``` 執行個體搜尋結果會以 JSON 格式傳回，依遞增順序排序 `Instance Number (0020,0013)` （最舊到最新） ------