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

# 在 HealthImaging 中搜尋 DICOM 執行個體
<a name="dicomweb-search-instances"></a>

使用 `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)` （最舊到最新）

------