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

# 從 HealthImaging 取得 DICOM 執行個體中繼資料
<a name="dicomweb-retrieve-instance-metadata"></a>

使用 `GetDICOMInstanceMetadata`動作，透過指定與資源相關聯的序列、研究和執行個體 UIDs，從 HealthImaging [資料存放](getting-started-concepts.md#concept-data-store)區中的 DICOM 執行個體擷取中繼資料。除非提供選用的影像集參數，否則 API 只會從主要[影像集](getting-started-concepts.md#concept-image-set)傳回執行個體中繼資料。您可以透過將 指定`imageSetId`為查詢參數，擷取資料存放區中的任何執行個體中繼資料 （來自主要或非主要影像集）。

**取得 DICOM 執行個體中繼資料 (`.json`)**  


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

1. 使用 [https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_GetImageSetMetadata.html](https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_GetImageSetMetadata.html)動作搭配 `datastoreId`和 `imageSetId` 參數值，擷取 `studyInstanceUID`、 `seriesInstanceUID`和 的相關中繼資料值`sopInstanceUID`。如需詳細資訊，請參閱[取得映像集中繼資料](get-image-set-metadata.md)。

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

   ```
   GET https://dicom-medical-imaging.{{region}}.amazonaws.com/datastore/{{datastore-id}}/studies/{{study-instance-uid}}/series/{{series-instance-uid}}/instances/{{sop-instance-uid}}/metadata?imageSetId={{image-set-id}}
   ```

1. 準備並傳送您的請求。 `GetDICOMInstanceMetadata`使用 HTTP GET 請求搭配 [AWS Signature 第 4 版](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html)簽署通訊協定。下列程式碼範例使用`curl`命令列工具，從 HealthImaging 取得 DICOM 執行個體中繼資料 (`.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/instances/1.3.6.1.4.1.5962.1.1.4.1.1.20040826186059.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'
   ```

------
**注意**  
中繼資料中指出的 Transfer Syntax UID 符合 HealthImaging 中的 Stored Transfer Syntax UID (`StoredTransferSyntaxUID`)。