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

命名空间主题订阅的传递属性

事件订阅让你可以设置已传递事件中将包含的 HTTP 头。 此功能可用于设置目标所需的自定义标头。 创建事件订阅时,最多可以设置 10 个标头。 每个标头值不应大于 4096 (4K) 字节。

可以对传递到以下目标的事件设置自定义标头:Azure 事件中心。

在 Azure 门户中创建事件订阅时,可使用“传递属性”选项卡设置自定义 HTTP 头。 在此页中可以设置固定的和动态的标头值。

设置静态标头值

若要设置一个值固定的标头,请在相应字段中提供标头的名称及其值:

Screenshot that shows the Delivery Properties tab of the Create Event Subscription page with an example static header.

提供敏感数据时,可能需要选中“是否为机密?”。 Azure 门户中敏感数据的可见性取决于用户的基于角色的访问控制 (RBAC) 权限。

设置动态标头值

可根据传入事件中的属性设置标头的值。 使用 JsonPath 语法来引用传入事件的属性值,以用作传出请求中的标头的值。 仅支持字符串、数字和布尔值的 JSON 值。 例如,要使用事件数据中传入事件属性 system 的值设置名为“Channel”的标头的值,请按以下方式配置事件订阅

Screenshot that shows the Delivery Properties tab of the Create Event Subscription page with an example dynamic header.

示例

本节提供几个使用传递属性的示例。

事件中心示例

如果需要将事件发布到某个事件中心内的特定分区,请在事件订阅上设置 PartitionKey 属性,以指定用于标识目标事件中心分区的分区键。

标头名称 标头类型
PartitionKey 静态或动态

也可以在向事件中心发送消息时指定自定义属性。 请勿为属性名称使用 aeg- 前缀,因为消息标头中的系统属性会使用它。 如需消息标头属性的列表,请参阅事件中心作为事件处理程序

后续步骤

有关事件传递的详细信息,请参阅以下文章: