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

# 正在中搜索 DICOM 实例 HealthImaging
<a name="dicomweb-search-instances"></a>

使用 `SearchDICOMInstances` API 在 HealthImaging [数据存储](getting-started-concepts.md#concept-data-store)中搜索 DICOM 实例。您可以 HealthImaging 通过构造包含支持的 DICOM 数据元素（属性）的 URL 来在中搜索 DICOM 实例。实例结果以 JSON 格式返回，按升序排序（从最旧到最新）。

**搜索 DICOM 实例**  


1. 收集 HealthImaging `region`和`datastoreId`价值。有关更多信息，请参阅 [获取数据存储属性](get-data-store.md)。

1. 收集`StudyInstanceUID`和的值`SeriesInstanceUID`。有关更多信息，请参阅 [获取影像集元数据](get-image-set-metadata.md)。

1. 为请求构建 URL，包括所有适用的搜索元素。要查看以下示例中的整个 URL 路径，请滚动到 “**复制**” 按钮。网址的格式为：

   ```
   GET https://dicom-medical-imaging.region.amazonaws.com/datastore/datastoreId/studies/StudyInstanceUID/series/SeriesInstanceUID/instances[?query]
   ```  
**的实例元素 `SearchDICOMInstances`**    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/healthimaging/latest/devguide/dicomweb-search-instances.html)

   HealthImaging 使用 DICOM 元素 [(0008,1196)](https://dicom.nema.org/dicom/2013/output/chtml/part18/sect_6.6.html#sect_6.6.1.3.2.1.1) 来保留导入警告代码。可以在实例级别搜索导入警告代码。可以使用通配符或特定的警告代码搜索导入警告代码。请参阅[HealthImaging 警告码](reference-warning-codes.md)。

1. 准备并发送您的请求。 `SearchDICOMInstances`使用带有[AWS 签名版本 4 签名](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html)协议的 HTTP GET 请求。以下示例使用`curl`命令行工具搜索有关 DICOM 实例的信息。

------
#### [ curl ]

   ```
   curl --request GET \
     "https://dicom-medical-imaging.us-east-1.amazonaws.com/datastore/datastoreId/studies/StudyInstanceUID/series/SeriesInstanceUID/instances[?query]"
     --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 results.json
   ```

   实例搜索结果以 JSON 格式返回，按`Instance Number (0020,0013)`升序排序（从最旧到最新）

------