翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# HealthImaging での DICOM データの検索
<a name="dicomweb-search"></a>

AWS HealthImaging は、[DICOMweb の "DO-RS](https://www.dicomstandard.org/using/dicomweb/query-qido-rs) APIs の表現を提供し、患者 ID で検査、シリーズ、インスタンスを検索し、さらに使用するための一意の識別子を受け取ります。HealthImaging の DICOMweb "DO-RS APIsは、HealthImaging に保存されているデータを検索する方法に柔軟性を提供し、レガシーアプリケーションとの相互運用性を提供します。

**[重要]**  
HealthImaging の DICOMweb APIs を使用して、画像セット情報を "DO-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 の "DO-RS アクションは、最大 10,000 件のレコードを返すことができます。10,000 を超えるリソースが存在する場合、これらは "DO-RS アクションでは取得できませんが、DICOMweb WADO-RS アクションまたは[クラウドネイティブアクション](https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_Operations.html)で取得できます。  
このセクションに記載されている APIs は、ウェブベースの医療画像用の DICOMweb ("DO-RS) 標準に準拠して構築されています。 AWS CLI および AWS SDKs では提供されません。

## HealthImaging の DICOMweb 検索 APIs
<a name="dicomweb-search-services"></a>

次の表は、HealthImaging でデータを検索するために使用できる DICOMweb "DO-RS APIs のすべての HealthImaging 表現を示しています。


**HealthImaging DICOMweb の "DO-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 インスタンスレベルで "DO-RS 階層型リソースクエリをサポートしています。HealthImaging に "DO-RS 階層検索を使用する場合:
+ スタディを検索すると、スタディのリストが返されます。
+ 研究のシリーズを検索するには既知の が必要`StudyInstanceUID`で、シリーズのリストが返されます。
+ インスタンスのリストを検索するには、既知の `StudyInstanceUID`と が必要です。 `SeriesInstanceUID`

次の表は、HealthImaging でデータを検索するためにサポートされている "DO-RS 階層クエリタイプを示しています。


**HealthImaging でサポートされている "DO-RS クエリタイプ**  

| クエリタイプ | 例 | 
| --- | --- | 
| 属性値のクエリ | で、スタディ内のすべてのシリーズを検索します`modality=CT`。<br />`.../studies/1.3.6.1.4.1.14519.5.2.1.6279.6001.101370605276577556143013894866/series?00080060=CT`<br />患者 ID と検査日がそれぞれこれらの値であるすべての検査を検索します。<br />`…/studies?PatientID=11235813&StudyDate=20130509` | 
| キーワードクエリ | `SeriesInstanceUID` キーワードを使用してすべてのシリーズを検索します。<br />`.../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` | 
| クエリにタグを付ける | グループ/要素フォームで渡されたクエリパラメータを使用してタグを検索します。<br />0020000D のような {group}{element} | 
| 範囲クエリ | `...?Modality=CT&StudyDate=AABBYYYY-BBCCYYYY` | 
| limit および を使用した結果のページング offset | `.../studies?limit=1&offset=0&00080020=20000101`<br />制限パラメータとオフセットパラメータを使用して、検索レスポンスをページ分割できます。制限のデフォルト値は 1000 です。最大値[AWS HealthImagingエンドポイントとクォータ](endpoints-quotas.md)については、「」を参照してください。<br />最大制限 = 1000、最大オフセット = 9000 | 
| ワイルドカードクエリ | ワイルドカードクエリは、「\*」と「？」を使用した検索の柔軟性を高めます。「\*」は任意の文字シーケンス (長さがゼロの値を含む) に一致し、「？」は任意の 1 文字に一致します。<br />StudyDescription に「Nuclear」が含まれているデータストア内のすべての研究を検索します。<br />`.../studies?StudyDescription=*Nuclear*`<br />StudyDescription が「Nuclear」で終わるすべての研究を検索します。<br />`.../studies?StudyDescription=*Nuclear`<br />StudyDescription が「Nuclear」で始まるすべての研究を検索します。<br />`.../studies?StudyDescription=Nuclear*`<br />PatientID が 200965981 の後に 3 文字のみを持つすべての治験を検索します。<br />`.../studies?PatientID=200965981???` | 
| FuzzyMatching クエリ | ファジーマッチングオプションのクエリパラメータを追加して、名前の DICOM 属性 (PatientName (0010,0010), ReferringPhysicianName(0008,0090)) であいまいマッチングを有効にします。<br />`.../studies?fuzzymatching=true&PatientName="Thomas^Albert"`<br />このクエリは、 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)