翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # HealthImaging から DICOM インスタンスを取得する `GetDICOMInstance` アクションを使用して、リソースに関連付けられたシリーズ、治験、インスタンス UIDs を指定して、HealthImaging [データストア](getting-started-concepts.md#concept-data-store)から DICOM インスタンス (`.dcm` ファイル) を取得します。API は、オプションのイメージセット[パラメータが指定されていない限り、プライマリイメージセット](getting-started-concepts.md#concept-image-set)からのみインスタンスを返します。をクエリパラメータ`imageSetId`として指定することで、データストア内の任意のインスタンス (プライマリまたは非プライマリイメージセットから) を取得できます。DICOM データは、保存された転送構文または非圧縮 (ELE) 形式で取得できます。 **DICOM インスタンスを取得するには (`.dcm`)** 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`、および の値を使用して`sopInstanceUID`、リクエストの URL `seriesInstanceUID`を作成します`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?imageSetId=image-set-id ``` 1. リクエストを準備して送信します。 は署名[AWS バージョン 4 ](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html)の署名プロトコルで HTTP GET リクエスト`GetDICOMInstance`を使用します。次のコード例では、 `curl` コマンドラインツールを使用して HealthImaging から DICOM インスタンス (`.dcm` ファイル) を取得します。 ------ #### [ 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?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; transfer-syntax=1.2.840.10008.1.2.1' \ --output 'dicom-instance.dcm' ``` ------ **注記** `transfer-syntax` UID はオプションであり、含まれていない場合はデフォルトで Explicit VR Little Endian になります。サポートされている転送構文は次のとおりです。 明示的な VR リトルエンディアン (ELE) - `1.2.840.10008.1.2.1` (可逆画像フレームのデフォルト) `transfer-syntax=*` その場合、イメージフレーム (複数可) は保存された転送構文で返されます。 高スループット JPEG 2000 with RPCL Options Image Compression (Lossless Only) - `1.2.840.10008.1.2.4.202` - インスタンスが HealthImaging に次のように保存されている場合 `1.2.840.10008.1.2.4.202` JPEG 2000 可逆 - `1.2.840.10008.1.2.4.90` - インスタンスが可逆として HealthImaging に保存されている場合。 JPEG ベースライン (プロセス 1): 損失 JPEG 8 ビットイメージ圧縮のデフォルトの転送構文 - - `1.2.840.10008.1.2.4.50` インスタンスが HealthImaging に として保存されている場合 `1.2.840.10008.1.2.4.50` JPEG 2000 Image Compression - `1.2.840.10008.1.2.4.91` - インスタンスが HealthImaging に次のように保存されている場合 `1.2.840.10008.1.2.4.91` 高スループット JPEG 2000 イメージ圧縮 - `1.2.840.10008.1.2.4.203` - インスタンスが HealthImaging に として保存されている場合 `1.2.840.10008.1.2.4.203` JPEG XL イメージ圧縮 - `1.2.840.10008.1.2.4.112` - インスタンスが HealthImaging に次のように保存されている場合 `1.2.840.10008.1.2.4.112` HealthImaging に保存されているインスタンスは、[転送構文](supported-transfer-syntaxes.md)の MPEG ファミリー (MPEG2, MPEG-4 AVC/H.264、HEVC/H.265 を含む) でエンコードされた 1 つ以上のイメージフレームを使用して、対応する転送構文 UID で取得できます。たとえば、インスタンスが MPEG2 Main Profile Main Level として保存`1.2.840.10008.1.2.4.100`されている場合です。 詳細については、「[サポートされる転送構文](supported-transfer-syntaxes.md)」および「[AWS HealthImaging の画像フレームデコードライブラリ](reference-libraries.md)」を参照してください。