翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # HealthImaging からの DICOM インスタンスフレームの取得 `GetDICOMInstanceFrames` アクションを使用して、HealthImaging [データストア](getting-started-concepts.md#concept-data-store)の DICOM インスタンスから単一またはバッチイメージフレーム (`multipart` リクエスト) を取得するには、リソースに関連付けられたシリーズ UID、治験 UID、インスタンス UIDs、フレーム番号を指定します。[イメージセット](getting-started-concepts.md#concept-image-set) ID をクエリパラメータとして指定することで、インスタンスフレームを取得するイメージセットを指定できます。API は、オプションのイメージセットパラメータが指定されていない限り、プライマリ[イメージセット](getting-started-concepts.md#concept-image-set)からのインスタンスフレームのみを返します。をクエリパラメータ`imageSetId`として指定することで、データストア内の任意のインスタンスフレーム (プライマリまたは非プライマリイメージセットから) を取得できます。 DICOM データは、保存された転送構文または非圧縮 (ELE) 形式で取得できます。 **DICOM インスタンスフレームを取得するには (`multipart`)** 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`パラメータ値とともに使用して`seriesInstanceUID`、`studyInstanceUID`、、および の関連するメタデータ値を取得します`sopInstanceUID`。詳細については、「[画像セットメタデータの取得](get-image-set-metadata.md)」を参照してください。 1. 関連するメタデータから取得するイメージフレームを決定して、 `frameList`パラメータを形成します。`frameList` パラメータは、任意の順序で 1 つ以上の重複しないフレーム番号のカンマ区切りリストです。たとえば、メタデータの最初のイメージフレームはフレーム 1 になります。 + 単一フレームリクエスト: `/frames/1` + マルチフレームリクエスト: `/frames/1,2,3,4` 1. 、、`datastoreId`、`studyInstanceUID`、`seriesInstanceUID`、および の値を使用して`imageSetId`、リクエストの URL `sopInstanceUID`を作成します`frameList`。次の例の 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/frames/1?imageSetId=image-set-id ``` 1. リクエストを準備して送信します。 は署名[AWS バージョン 4 ](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html)の署名プロトコルで HTTP GET リクエスト`GetDICOMInstanceFrames`を使用します。次のコード例では、 `curl` コマンドラインツールを使用して、HealthImaging からの`multipart`レスポンスでイメージフレームを取得します。 ------ #### [ 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-syntax` UID はオプションであり、含まれていない場合はデフォルトで Explicit VR Little Endian になります。ELE へのトランスコードが実行可能でない場合 (警告付きのインポートのため）、ピクセルはトランスコードなしで返されます。サポートされている転送構文は次のとおりです。 明示的な 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`されている場合です。 リクエストされた転送構文`NotAcceptableException`をストアド転送構文に基づいて返すことができない場合、またはインスタンスに特定の処理警告がある場合、406 が表示されることがあります。これが発生した場合は、 で呼び出しを再試行します`transfer-syntax=*`。 詳細については、「[サポートされる転送構文](supported-transfer-syntaxes.md)」および「[AWS HealthImaging の画像フレームデコードライブラリ](reference-libraries.md)」を参照してください。