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

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

`SearchDICOMStudyInstances` API を使用して、HealthImaging [データストア](getting-started-concepts.md#concept-data-store)内の検査内のすべての DICOM インスタンスを検索します。サポートされている DICOM データ要素 (属性) を使用してリクエスト URL を作成し、結果をフィルタリングします。API は、インスタンスの検索結果を JSON 形式で、最終更新日順に降順 (最新から最新) で返します。

**検査の DICOM インスタンスを検索するには**  


1. HealthImaging `region`と`datastoreId`値を収集します。詳細については、「[データストアのプロパティの取得](get-data-store.md)」を参照してください。

1. `StudyInstanceUID` 値を収集します。詳細については、「[画像セットメタデータの取得](get-image-set-metadata.md)」を参照してください。

1. 該当するすべての検索要素を含む、リクエストの URL を作成します。URL は 形式です。

   ```
   GET https://dicom-medical-imaging.{{region}}.amazonaws.com/datastore/{{datastoreId}}/studies/{{StudyInstanceUID}}/instances[?query]
   ```

   次の表に、サポートされている DICOM データ要素 (属性) を示します。  
**のインスタンス要素 `SearchDICOMStudyInstances`**    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/healthimaging/latest/devguide/dicomweb-search-study-instances.html)

1. リクエストを準備して送信します。 は、[AWS 署名バージョン 4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html) で署名された HTTP GET リクエスト`SearchDICOMStudyInstances`を使用します。次の例では、 `curl` コマンドラインツールを使用します。を自分の AWS リージョン`{{region}}`に置き換えます。をデータストア ID `{{datastoreId}}`に置き換えます。を検査の UID `{{StudyInstanceUID}}`に置き換えます。

------
#### [ curl ]

   ```
   curl --request GET \
     "https://dicom-medical-imaging.{{region}}.amazonaws.com/datastore/{{datastoreId}}/studies/{{StudyInstanceUID}}/instances[?query]" \
     --aws-sigv4 'aws:amz:{{region}}: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
   ```

------