

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# HealthImaging からの DICOM シリーズメタデータの取得
<a name="dicomweb-retrieve-series-metadata"></a>

`GetDICOMSeriesMetadata` アクションを使用して、HealthImaging [データストア](getting-started-concepts.md#concept-data-store)から DICOM シリーズ (`.json` ファイル) のメタデータを取得します。リソースに関連付けられた Study および Series UIDs を指定することで、HealthImaging データストア内の任意のプライマリ[イメージセット](getting-started-concepts.md#concept-image-set)のシリーズメタデータを取得できます。非プライマリイメージセットのシリーズメタデータを取得するには、イメージセット ID をクエリパラメータとして指定します。シリーズメタデータは `DICOM JSON`形式で返されます。

**DICOM シリーズメタデータを取得するには (`.json`)**  


1. HealthImaging `datastoreId`と`imageSetId`パラメータ値を収集します。

1. 、`datastoreId`、`studyInstanceUID`、およびオプションで の値を使用して`seriesInstanceUID`、リクエストの URL を作成します`imageSetId`。次の例の URL パス全体を表示するには、**コピー**ボタンをスクロールします。URL は 形式です。

   ```
   GET https://dicom-medical-imaging.region.amazonaws.com/datastore/datastore-id/studies/study-instance-uid/series/series-instance-uid/metadata
   ```

1. リクエストを準備して送信します。 は署名[AWS バージョン 4 ](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html)の署名プロトコルで HTTP GET リクエスト`GetDICOMSeriesMetadata`を使用します。次のコード例では、 `curl` コマンドラインツールを使用して HealthImaging からメタデータ (`.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/metadata \
     --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' \
     --output 'series-metadata.json'
   ```

------

   オプションの `imageSetId`パラメータ。

------
#### [ 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/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' \
     --output 'series-metadata.json'
   ```

------
**注記**  
`imageSetId` パラメータは、プライマリ以外のイメージセットのシリーズメタデータを取得するために必要です。`GetDICOMInstanceMetadata` アクションは、`datastoreId`、、 `seriesInstanceUID`が指定されている ( なし) 場合にのみ`studyInstanceUID`、プライマリイメージセットのシリーズメタデータを返します`imagesetID`。