從 HealthImaging 取得 DICOM 執行個體中繼資料 - AWS HealthImaging

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

從 HealthImaging 取得 DICOM 執行個體中繼資料

使用 GetDICOMInstanceMetadata動作，透過指定與資源相關聯的序列、研究和執行個體 UIDs，從 HealthImaging 資料存放區中的 DICOM 執行個體擷取中繼資料。除非提供選用的影像集參數，否則 API 只會傳回主要影像集的執行個體中繼資料。您可以透過將 指定imageSetId為查詢參數，擷取資料存放區中的任何執行個體中繼資料 （從主要或非主要影像集）。

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

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

  2. 使用 GetImageSetMetadata動作搭配 datastoreId和 imageSetId 參數值，擷取 studyInstanceUID、 seriesInstanceUID和 的相關中繼資料值sopInstanceUID。如需詳細資訊，請參閱取得映像集中繼資料。

  3. 使用 datastoreId、studyInstanceUID、、 seriesInstanceUIDsopInstanceUID和 的值來建構請求的 URLimageSetId。若要在下列範例中檢視整個 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

  4. 準備並傳送您的請求。 GetDICOMInstanceMetadata使用 HTTP GET 請求搭配 AWS Signature 第 4 版簽署通訊協定。下列程式碼範例使用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)。