

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

# HealthImaging からの DICOM インスタンスメタデータの取得
<a name="dicomweb-retrieve-instance-metadata"></a>

`GetDICOMInstanceMetadata` アクションを使用して、リソースに関連付けられたシリーズ、治験、インスタンス UIDs を指定して、HealthImaging [ データストア](getting-started-concepts.md#concept-data-store)の DICOM インスタンスからメタデータを取得します。API は、オプションのイメージセットパラメータが指定されていない限り、プライマリ[イメージセット](getting-started-concepts.md#concept-image-set)からのみインスタンスメタデータを返します。をクエリパラメータ`imageSetId`として指定することで、データストア内の任意のインスタンスメタデータ (プライマリまたは非プライマリイメージセットから) を取得できます。

**DICOM インスタンスメタデータを取得するには (`.json`)**  


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}}/metadata?imageSetId={{image-set-id}}
   ```

1. リクエストを準備して送信します。 は署名[AWS バージョン 4 ](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html)の署名プロトコルで HTTP GET リクエスト`GetDICOMInstanceMetadata`を使用します。次のコード例では、 `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'
   ```

------
**注記**  
メタデータに示されている転送構文 UID は、HealthImaging のストアド転送構文 UID (`StoredTransferSyntaxUID`) と一致します。