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

# 從 HealthImaging 取得 DICOM 系列中繼資料
<a name="dicomweb-retrieve-series-metadata"></a>

使用 `GetDICOMSeriesMetadata`動作從 HealthImaging [資料存放區](getting-started-concepts.md#concept-data-store)擷取 DICOM 系列 (`.json` 檔案） 的中繼資料。您可以透過指定與資源相關聯的檢查和序列 UIDs，擷取 HealthImaging 資料存放區中任何主要[影像集](getting-started-concepts.md#concept-image-set)的序列中繼資料。您可以透過提供影像集 ID 做為查詢參數，擷取非主要影像集的序列中繼資料。系列中繼資料會以 `DICOM JSON` 格式傳回。

**若要取得 DICOM 系列中繼資料 (`.json`)**  


1. 收集 HealthImaging `datastoreId`和`imageSetId`參數值。

1. 使用 `datastoreId`、`seriesInstanceUID`、 `studyInstanceUID`和選擇性 的值來建構請求的 URL`imageSetId`。若要在下列範例中檢視整個 URL 路徑，請捲動至**複製**按鈕。URL 的格式如下：

   ```
   GET https://dicom-medical-imaging.region.amazonaws.com/datastore/datastore-id/studies/study-instance-uid/series/series-instance-uid/metadata
   ```

1. 準備並傳送您的請求。 `GetDICOMSeriesMetadata`使用 HTTP GET 請求搭配 [AWS Signature 第 4 版](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html)簽署通訊協定。下列程式碼範例使用`curl`命令列工具，從 HealthImaging 取得中繼資料 (`.json` 檔案）。

------
#### [ Shell ]

   ```
   curl --request GET \
    'https://dicom-medical-imaging.us-east-1.amazonaws.com/datastore/d9a2a515ab294163a2d2f4069eed584c/studies/1.3.6.1.4.1.5962.1.2.4.20040826285059.5457/series/1.3.6.1.4.1.5962.1.3.4.1.20040825185059.5457/metadata \
     --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 'series-metadata.json'
   ```

------

   使用選用`imageSetId`參數。

------
#### [ Shell ]

   ```
   curl --request GET \
     'https://dicom-medical-imaging.us-east-1.amazonaws.com/datastore/d9a2a515ab294163a2d2f4069eed584c/studies/1.3.6.1.4.1.5962.1.2.4.20040826285059.5457/series/1.3.6.1.4.1.5962.1.3.4.1.20040825185059.5457/metadata?imageSetId=459e50687f121185f747b67bb60d1bc8' \
     --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 'series-metadata.json'
   ```

------
**注意**  
需要 `imageSetId` 參數才能擷取非主要影像集的序列中繼資料。只有在`seriesInstanceUID`指定 `datastoreId`、、 （沒有 ) 時`studyInstanceUID`， `GetDICOMInstanceMetadata`動作才會傳回主要影像集的序列中繼資料`imagesetID`。