從中獲取DICOM實例框架 HealthImaging

透過指定與資源關聯的「系列」UID、「研究UID」、「DICOM實例」和「畫面編號」，使用此GetDICOMInstanceFrames動作可從資 HealthImaging 料倉庫中的實例UIDs擷取單一或批次影像畫格 (multipart請求)。您可以提供影像集 ID 做為查詢參數，來指定應從中擷取實例畫面的影像集。此外，您可以選擇傳輸語法來壓縮影像幀資料，並支援未壓縮 (ELE) 或高輸送量 JPEG 2000 (HTJ2K)。

注意

使用時GetDICOMInstanceFrames，您可以與使用DICOM第 10 部分二進位檔案的 HealthImaging系統互操作，同時利用雲端原生動作。

若要取得DICOM實體框架 (multipart)

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

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

3. 決定要從關聯中繼資料擷取的影像框，以形成frameList參數。此frameList參數是以逗號分隔的清單，其中包含一或多個非重複影格編號 (以任何順序排列)。例如，中繼資料中的第一個影像影格將是影格 1。

   • 單一影格要求：/frames/1

   • 多幀請求：/frames/1,2,3,4

4. 使用datastoreId、、、、studyInstanceUID和的值來建構請求frameList。URL seriesInstanceUID sopInstanceUID imageSetId若要在下列範例中檢視整個URL路徑，請在「複製」按鈕上捲動。URL的形式是：

   https://dicom-medical-imaging.region.amazonaws.com/datastore/datastore-id/studies/study-instance-uid/series/series-instance-uid/instances/sop-instance-uid/frames/1?imageSetId=image-set-id
   

5. 準備並發送您的請求。 GetDICOMInstanceFrames使用具有簽AWS 名版本 4 簽名協議的HTTPGET請求。下列程式碼範例使用curl指令行工具取得multipart回應中的影像框 HealthImaging。

   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/frames/1?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: multipart/related; type=application/octet-stream; transfer-syntax=1.2.840.10008.1.2.1'
   

   注意

   transfer-syntaxUID這是可選的，如果不包含，則默認為「顯式 VR 小端序」。支援的傳輸語法包括：

   • 顯式 VR 小端序（ELE）-1.2.840.10008.1.2.1（默認）

   • 高通量 JPEG 2000 與RPCL選項圖像壓縮（僅限無損）-1.2.840.10008.1.2.4.202

     如需詳細資訊，請參閱適用於 AWS 的 HTJ2K 解碼程式庫 HealthImaging。