你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
DICOM 服务 API v2 更改
本参考指南提供了 DICOM® 服务的 V2 API 中的更改摘要。 若要查看 v2 中的完整功能集，请参阅 DICOM 一致性语句 v2。
v2 中的更改摘要
商店
可选属性的 Lenient 验证
在以前的版本中，如果任何必需属性或可搜索属性都未能通过验证，应用商店请求将失败。 从 v2 开始，仅当所需的属性验证失败时，请求才会失败。
API 不需要对属性的验证失败，导致文件在响应中存储有警告。 警告导致 HTTP 返回代码 202 Accepted ，并且响应有效负载包含 WarningReason 标记 （0008, 1196）。
针对每个实例的每个失败属性发出警告。 如果序列包含验证失败的属性，或者单个属性存在多个问题，则只会指出第一个失败的属性原因。
对于无法验证的可选属性，有一些值得注意的行为：
- 如果用此处提到的几种方法之一更正了值，则搜索验证失败的属性将返回研究/系列/实例。
- 通过 WADO
/metadata终结点检索元数据时，不会返回这些属性。
检索研究/系列/实例始终返回具有原始属性的原始二进制文件，即使这些属性未通过验证也是如此。
如果属性填充为 null，则当可搜索且存储为 dicom+json 元数据时，该属性将编制索引。 未提供验证警告。
检索
单帧检索支持
通过添加以下 Accept 标头支持单帧检索：
application/octet-stream; transfer-syntax=*
Search
对于带有验证警告的扩展查询标记，搜索结果可能不完整
在 v1 API 中，如果扩展查询标记有任何错误，因为一个或多个现有实例具有无法编制索引的标记值，则包含扩展查询标记的后续搜索查询会返回文档中的详细内容erroneous-dicom-attributes。 但是，包含 STOW-RS 验证警告的标记（也称为属性）不包括 在此标头中。 如果存储请求在存储实例时导致可搜索属性的验证警告，则这些属性可能不用于搜索存储的实例。 但是，如果值被存储在失败的同一个研究/系列中的实例覆盖，或者如果值已由上一个实例正确存储，则验证失败的任何 可搜索属性 都能够返回结果。 如果未覆盖属性值，则不会生成任何搜索结果。
可以通过以下方式更正属性：
- 删除存储的实例并上传包含更正数据的新实例
- 在同一个研究/系列中上传包含更正数据的新实例
默认情况下返回较少的研究、序列和实例属性
默认情况下返回的属性集已减少，以提高性能。 请参阅搜索响应文档中的详细列表。
新添加到默认标记的属性。
| 标记级别 | 标记 | 属性名称 |
|---|---|---|
| 检查 | (0008, 1030) | StudyDescription |
| Series | (0008, 1090) | ManufacturerModelName |
从默认标记中删除的属性。
| 标记级别 | 标记 | 属性名称 |
|---|---|---|
| 检查 | (0008, 0005) | SpecificCharacterSet |
| 检查 | (0008, 0030) | StudyTime |
| 检查 | (0008, 0056) | InstanceAvailability |
| 检查 | (0008, 0201) | TimezoneOffsetFromUTC |
| 检查 | (0010, 0040) | PatientSex |
| 检查 | (0020, 0010) | StudyID |
| Series | (0008, 0005) | SpecificCharacterSet |
| Series | (0008, 0201) | TimezoneOffsetFromUTC |
| Series | (0008, 103E) | SeriesDescription |
| Series | (0040, 0245) | PerformedProcedureStepStartTime |
| Series | (0040, 0275) | RequestAttributesSequence |
| 实例 | (0008, 0005) | SpecificCharacterSet |
| 实例 | (0008, 0016) | SOPClassUID |
| 实例 | (0008, 0056) | InstanceAvailability |
| 实例 | (0008, 0201) | TimezoneOffsetFromUTC |
| 实例 | (0020, 0013) | InstanceNumber |
| 实例 | (0028, 0010) | “行” |
| 实例 | (0028, 0011) | 列 |
| 实例 | (0028, 0100) | BitsAllocated |
| 实例 | (0028, 0008) | NumberOfFrames |
所有已删除的标记都是其他标记的一部分，在查询时 includefield = all将返回这些标记。
可以使用或不填充搜索空填充属性
使用 null 填充存储属性时，可以在 URI 编码中使用或不使用 null 填充来搜索它。 检索的结果适用于同时存储且不带 null 填充的属性。
Operations
状态 completed 已重命名为 succeeded
为了与 Microsoft的 REST API 准则保持一致，状态 completed 已重命名为 succeeded。
更改源
更改源现在接受时间范围
更改源 API 现在接受可选 startTime 和 endTime 参数来帮助确定结果的范围。 仍可使用现有 offset 参数 limit 分页时间范围内的更改。 偏移量与由 startTime 和 endTime定义的时间窗口相对。 例如，从 2023 年 7 月 24 日上午 09：00 UTC 开始的第五个更改源条目将使用查询字符串 ?startTime=2023-07-24T09:00:00Z&offset=5。
对于 v2，建议始终包含一个时间范围以提高性能。
注意
DICOM® 是美国电气制造商协会的注册商标，适用于其有关医疗信息数字通信的标准出版物。