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

# 在 HealthImaging 中搜尋 DICOM 系列
<a name="dicomweb-search-series"></a>

使用 `SearchDICOMSeries` 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`值。如需詳細資訊，請參閱[取得映像集中繼資料](get-image-set-metadata.md)。

1. 建構請求的 URL，包括所有適用的序列元素。若要在下列範例中檢視整個 URL 路徑，請捲動至**複製**按鈕。URL 的格式如下：

   ```
   GET https://dicom-medical-imaging.region.amazonaws.com/datastore/datastoreId/studies/StudyInstanceUID/series[?query]
   ```  
**的系列元素 `SearchDICOMSeries`**    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/healthimaging/latest/devguide/dicomweb-search-series.html)

1. 準備並傳送您的請求。 `SearchDICOMSeries`使用 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/StudyInstanceUID/series[?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 格式傳回，依遞增順序 `Series Number (0020,0011)` （最舊到最新） 排序。

------