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

# 在 HealthImaging 中搜尋 DICOM 檢查
<a name="dicomweb-search-studies"></a>

使用 `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 格式傳回，依上次更新、日期遞減 （最晚到最舊） 排序。

------