使用英语阅读

通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

什么是 URL 操作

  • 项目

使用 URL 操作可以自定义响应对象中的图像位置的 URL。

对于以下 API 操作，DICOM 服务在响应对象的 DICOM 标记 (UR) 下的响应对象中返回图像位置的完全限定 URL。

  • 检索 Instance
  • 检索 WorkItems
  • 检索 OperationStatus
  • 解析 QueryTag
  • 解析 QueryTagError

下面是完全限定的图像位置 URL 的示例。 对于启用了数据分区（分区名称为“foo”）的 DICOM 服务的 STOW 操作，可以在标准响应中找到 URL。

https://localhost:63838/v2/partitions/foo/studies/1.2.826.0.1.3680043.8.498.13230779778012324449356534479549187420/series/1.2.826.0.1.3680043.8.498.77033797676425927098669402985243398207/instances/1.2.826.0.1.3680043.8.498.13273713909719068980354078852867170114

上述 URL 由三个部分组成：

  • hostname ->https://localhost:63838（DICOM 服务的主机名）
  • path ->v2/partitions/foo（表示正在使用的 DICOM 服务版本的路径，如果启用了数据分区，该路径还表示数据分区名称）
  • DICOM Web 标准路径 ->studies/1.2.826.0.1.3680043.8.498.13230779778012324449356534479549187420/series/1.2.826.0.1.3680043.8.498.77033797676425927098669402985243398207/instances/1.2.826.0.1.3680043.8.498.13273713909719068980354078852867170114

此功能允许根据提供的请求标头自定义图像 URL 的路径（如果客户端已指示）。

工作原理

修改后的 URL 基于以下两个标头。

  • X-Forwarded-Host：原始主机的域名（客户端在代理或负载均衡器处理请求之前请求的域名）。 例如：X-Forwarded-Host: www.example.com

  • X-Forwarded-Prefix：在客户端请求中在代理转发或更改请求之前的原始 URL 路径或前缀。 例如：X-Forwarded-Prefix: /prefix

这些标头是 .NET Core 标准转发标头的一部分。

如果请求对象中存在 x-forwarded-host 标头，此标头会将主机名替换为提供的值。

如果请求对象中存在 x-forwarded-prefix 标头，此标头会将路径替换为提供的值。

可使用转发标头进行 URL 操作的服务列表

  • Store(STOW-RS)：将 DICOM 对象上传到服务器。
  • Retrieve(WADO-RS)：从服务器下载 DICOM 对象。
  • 工作列表服务（UPS 推送和拉取 SOP）：管理和跟踪医疗成像工作流。
  • 扩展查询标记：定义用于查询 DICOM 数据的自定义标记。
  • 操作状态

下面是具有转发标头时 STOW 操作的请求标头的详细信息：

  • Path：../studies/{study}
  • 方法：POST
  • 标头：
    • Accept：application/DICOM+json
    • Content-Type：multipart/related; type="application/DICOM"
    • Authorization：持有者令牌 {token value}
    • X-Forwarded-Host：{原始主机的域名}
    • X-Forwarded-Prefix: {原始 URL 路径}
  • 正文：
    • Content-Type：上传的每个文件的 application/DICOM，用边界值分隔

示例：

未提供转发标头时，STOW 操作的 VR = UR 的 DICOM 标记示例如下所示。

https://localhost:63838/v2/partitions/foo/studies/1.2.826.0.1.3680043.8.498.13230779778012324449356534479549187420/series/1.2.826.0.1.3680043.8.498.77033797676425927098669402985243398207/instances/1.2.826.0.1.3680043.8.498.13273713909719068980354078852867170114

已提供转发标头时，STOW 操作的 VR = UR 的 DICOM 标记示例如下所示。

示例请求对象：

  • 路径：https://localhost:63838/v2/partitions/foo/studies/studies/{study}
  • 方法：POST
  • 标头：
    • Accept：application/DICOM+json
    • Content-Type：multipart/related; type="application/DICOM"
    • Authorization：持有者令牌 {token value}
    • X-Forwarded-Host：API.powershare.com
    • X-Forwarded-Prefix：/newbasePath
  • 正文：
    • Content-Type：上传的每个文件的 application/DICOM，用边界值分隔

图像的 URL：https://API.powershare.com/newbasePath/studies/1.2.826.0.1.3680043.8.498.13230779778012324449356534479549187420/series/1.2.826.0.1.3680043.8.498.45787841905473114233124723359129632652/instances/1.2.826.0.1.3680043.8.498.12714725698140337137334606354172323212

要记住的事项

  • 转发的标头不必一起使用。 如果需要，请替换主机名而不是路径。 只能使用转发的主机标头。 同样，如果需要替换路径，则只能使用转发的前缀标头。
  • 客户端负责将转发标头中提供的主机名和路径映射到正确的 DICOM 服务主机名和路径库。

备注

DICOM® 是美国电气制造商协会的注册商标，适用于其有关医疗信息数字通信的标准出版物。