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

# 在中搜索 DICOM 数据 HealthImaging
<a name="dicomweb-search"></a>

AWS HealthImaging 提供 [ DICOMweb QIDO-R](https://www.dicomstandard.org/using/dicomweb/query-qido-rs) APIs S 的陈述，用于按患者 ID 搜索研究、系列和实例，并接收其唯一标识符以供进一步使用。 HealthImaging的 DICOMweb QIDO-RS APIs 可以灵活地搜索存储在中的数据， HealthImaging 并提供与传统应用程序的互操作性。

**重要提示**  
HealthImaging's DICOMweb APIs 可用于通过 QIDO-RS 返回影像集信息。 HealthImaging DICOMweb APIs 除非另有说明，否则仅引用[图像集](getting-started-concepts.md#concept-image-set)。使用 HealthImaging[云原生操作](https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_Operations.html)或 DICOMweb 操作的可选图像集参数来检索非主图像集。 HealthImaging's DICOMweb APIs 可用于返回响应 DICOMweb符合-formant 的图像集信息。  
 HealthImaging DICOMweb QIDO-RS 操作最多可以返回 10,000 条记录。[如果存在超过 10,000 个资源，则无法通过 QIDO-RS 操作检索这些资源，但可以通过 DICOMweb WADO-RS 操作或云原生操作进行检索。](https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_Operations.html)  
本节中 APIs 列出的内容符合基于 Web 的医学成像 DICOMweb (QIDO-RS) 标准。它们不是通过 AWS CLI 和提供 AWS SDKs的。

## DICOMweb APIs 搜索 HealthImaging
<a name="dicomweb-search-services"></a>

下表描述了 APIs 可用于在中搜索数据的 DICOMweb QIDO-RS 的所有 HealthImaging 表示形式。 HealthImaging


**HealthImaging QIDO-RS 的 DICOMweb 陈述 APIs**  

| Name | 说明 | 
| --- | --- | 
| SearchDICOMStudies | 使用 GET 请求指定搜索查询元素，在中 HealthImaging 搜索 DICOM 研究。研究搜索结果以 JSON 格式返回，按上次更新排序，日期降序（从最新到最旧）。请参阅[搜索研究](dicomweb-search-studies.md)。 | 
| SearchDICOMSeries | 使用 GET 请求指定搜索查询元素，在中 HealthImaging 搜索 DICOM 系列。系列搜索结果以 JSON 格式返回，按Series Number (0020, 0011)升序排序（从最旧到最新）。请参阅[搜索系列](dicomweb-search-series.md)。 | 
| SearchDICOMInstances | 使用 GET 请求指定搜索查询元素，在中 HealthImaging 搜索 DICOM 实例。实例搜索结果以 JSON 格式返回，按Instance Number (0020, 0013)升序排序（从最旧到最新）。请参阅[搜索实例](dicomweb-search-instances.md)。 | 

## 支持的 DICOMweb 查询类型 HealthImaging
<a name="dicomweb-query-types"></a>

HealthImaging 支持研究、系列和 SOP 实例级别的 QIDO-RS 分层资源查询。使用 QIDO-RS 分层搜索时： HealthImaging
+ 搜索研究会返回研究列表
+ 搜索研究系列需要已知序列`StudyInstanceUID`并返回系列列表
+ 搜索实例列表需要已知`StudyInstanceUID`和 `SeriesInstanceUID`

下表描述了支持的 QIDO-RS 分层查询类型，用于在中搜索数据。 HealthImaging


**HealthImaging 支持的 QIDO-RS 查询类型**  

| 查询类型 | 示例 | 
| --- | --- | 
| 属性值查询 | 在 “研究” 中搜索所有系列，其中`modality=CT`. `.../studies/1.3.6.1.4.1.14519.5.2.1.6279.6001.101370605276577556143013894866/series?00080060=CT` 搜索所有分别以患者身份和研究日期为这些值的研究。 `…/studies?PatientID=11235813&StudyDate=20130509` | 
| 关键字查询 | 使用`SeriesInstanceUID`关键字搜索所有系列。 `.../studies/1.3.6.1.4.1.14519.5.2.1.6279.6001.101370605276577556143013894866/series?SeriesInstanceUID=1.3.6.1.4.1.14519.5.2.1.6279.6001.101370605276577556143013894868` | 
| 标记查询 | 使用 group/element 表单中传递的查询参数搜索标签。 \$1group\$1 \$1element\$1 比如 0020000D | 
| 范围查询 |  `...?Modality=CT&StudyDate=AABBYYYY-BBCCYYYY`  | 
| 使用和进行分页的limit结果 offset | `.../studies?limit=1&offset=0&00080020=20000101` 您可以使用限制和偏移参数对搜索响应进行分页。限制的默认值为 1000，[AWS HealthImaging 终端节点和配额](endpoints-quotas.md)有关最大值，请参阅。 最大限制 = 1000，最大偏移量 = 9000  | 
| 通配符查询 |  通配符查询为使用 “\$1” 和 “？” 进行搜索提供了更大的灵活性。 “\$1” 匹配任何字符序列（包括零长度值）和 “？” 匹配任何单个字符。 在 StudyDescription 包含 “Nuclear” 的数据存储中搜索所有研究： `.../studies?StudyDescription=*Nuclear*` 搜索所有以 “核” StudyDescription 结尾的研究： `.../studies?StudyDescription=*Nuclear` 搜索所有以 “核” StudyDescription 开头的研究： `.../studies?StudyDescription=Nuclear*` 搜索所有在 200965981 之后的 patienTid 完全包含任意 3 个字符的研究： `.../studies?PatientID=200965981???`  | 
| FuzzyMatching 查询 |  通过添加模糊匹配可选查询参数，启用名称 DICOM 属性（PatientName (0010,0010)、 ReferringPhysicianName (0008,0090)）的模糊匹配： `.../studies?fuzzymatching=true&PatientName="Thomas^Albert"` 此查询对值的任何部分执行不区分大小写的前缀字匹配。 PatientName 它返回的结果 PatientName 值包括 “thomas”、“Albert”、“Thomas Albert”、“Thomas^Albert”，但不是 “hom” 或 “ber”。  | 

**Topics**
+ [DICOMweb APIs 搜索 HealthImaging](#dicomweb-search-services)
+ [支持的 DICOMweb 查询类型 HealthImaging](#dicomweb-query-types)
+ [正在搜索 DICOM 的研究 HealthImaging](dicomweb-search-studies.md)
+ [正在搜索 DICOM 系列 HealthImaging](dicomweb-search-series.md)
+ [正在中搜索 DICOM 实例 HealthImaging](dicomweb-search-instances.md)