本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 在中搜索 DICOM 数据 HealthImaging
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
下表描述了 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
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)
# 正在搜索 DICOM 的研究 HealthImaging
使用 `SearchDICOMStudies` 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. 为请求构建 URL，包括所有适用的研究元素。要查看以下示例中的整个 URL 路径，请滚动到 “**复制**” 按钮。网址的格式为：
```
GET https://dicom-medical-imaging.region.amazonaws.com/datastore/datastoreId/studies[?query]
```
**的研究要素 `SearchDICOMStudies`**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/healthimaging/latest/devguide/dicomweb-search-studies.html)
1. 准备并发送您的请求。 `SearchDICOMStudies`使用带有[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[?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 格式返回，按上次更新排序，日期降序（从最新到最旧）。
------
# 正在搜索 DICOM 系列 HealthImaging
使用 `SearchDICOMSeries` 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`价值。有关更多信息，请参阅 [获取影像集元数据](get-image-set-metadata.md)。
1. 为请求构建 URL，包括所有适用的系列元素。要查看以下示例中的整个 URL 路径，请滚动到 “**复制**” 按钮。网址的格式为：
```
GET https://dicom-medical-imaging.region.amazonaws.com/datastore/datastoreId/studies/StudyInstanceUID/series[?query]
```
**的系列元素 `SearchDICOMSeries`**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/healthimaging/latest/devguide/dicomweb-search-series.html)
1. 准备并发送您的请求。 `SearchDICOMSeries`使用带有[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[?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 格式返回，按`Series Number (0020,0011)`升序排序（从最旧到最新）。
------
# 正在中搜索 DICOM 实例 HealthImaging
使用 `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)`升序排序（从最旧到最新）
------