本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 从中获取 DICOM 系列元数据 HealthImaging
<a name="dicomweb-retrieve-series-metadata"></a>

使用`GetDICOMSeriesMetadata`操作从数据[存储中检索 DICOM 系列（`.json`文件）的元 HealthImaging 数据](getting-started-concepts.md#concept-data-store)。通过指定与资源 UIDs 关联的研究和系列，您可以检索 HealthImaging 数据存储中任何主[影像集](getting-started-concepts.md#concept-image-set)的系列元数据。您可以通过提供影像集 ID 作为查询参数来检索非主影像集的系列元数据。系列元数据以`DICOM JSON`格式返回。

**获取 DICOM 系列元数据 () `.json`**  


1. 收集 HealthImaging `datastoreId`和`imageSetId`参数值。

1. 使用`datastoreId`、`studyInstanceUID`、和（可选）的值为请求构造一个 URL `imageSetId`。`seriesInstanceUID`要查看以下示例中的整个 URL 路径，请滚动到 “**复制**” 按钮。网址的格式为：

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

1. 准备并发送您的请求。 `GetDICOMSeriesMetadata`使用带有[AWS 签名版本 4 签名](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html)协议的 HTTP GET 请求。以下代码示例使用`curl`命令行工具从中获取元数据（`.json`文件） 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/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`参数是检索非主影像集的系列元数据所必需的。仅当指定了、、（不带`imagesetID`）时 `datastoreId``studyInstanceUID`，`seriesInstanceUID`该`GetDICOMInstanceMetadata`操作才会返回主影像集的系列元数据。