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

# HealthImaging での DICOM インスタンスの検索
<a name="dicomweb-search-instances"></a>

`SearchDICOMInstances` API を使用して、HealthImaging [データストア](getting-started-concepts.md#concept-data-store)内の DICOM インスタンスを検索します。HealthImaging で DICOM インスタンスを検索するには、サポートされている DICOM データ要素 (属性) を含む URL を作成します。インスタンスの結果は、昇順 (最新から最新) の 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/ja_jp/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
   ```

   インスタンスの検索結果は、JSON 形式で、昇順 (最も古いものから最新のもの) `Instance Number (0020,0013)` の順に返されます。

------