更新主题

重要

此 API 已 过时，自2021 年 11 月 1 日停用，不应再使用。

更新主题。 在请求正文中发送已更新的描述符。 该 API 更新 FE/BE 条目中的主题项。

请求

方法	请求 URI	HTTP 版本
PUT	https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{Namespace}/Topics/{Topic Path}	HTTP/1.1

请求标头

下表介绍必需的和可选的请求标头。

请求标头	说明
x-ms-version	2012-03-01
If-Match	*

请求还需要客户端证书。 此证书必须与你为特定订阅上载的证书匹配。

请求正文

下表介绍了请求正文中的主要元素。 这些是你可以更新的仅有属性。 正文必须包含完整的主题说明，即使仅更改一个属性。 建议的流程如下所示：

1. 获取主题描述。

2. 更新所需的元素。

3. 传入已更新的描述。

属性名称	类型	说明
DefaultMessageTimeToLive	XML Datetime	根据是否启用死信，如果消息在主题中存储的时间超过指定时间，则会自动将其移动到死信队列或删除。 如果消息 TTL 小于主题上设置的 TTL，则在消息上指定的 TTL 会覆盖此值。 此值在创建主题后不可变： - 范围：1 秒 – 14 天。 - 默认值：14 天。
DuplicateDetectionHistoryTimeWindow	时间跨度	一个 属性，指定服务总线检测消息重复的时间跨度。 - 范围：1 秒 – 7 天。 - 默认值：10 分钟。
EnableFilteringMessagesBeforePublishing	布尔	一个 属性，指定在发布消息之前是否应用筛选。 有关详细信息，请参阅 EnableFilteringMessagesBeforePublishing。

响应

响应包括 HTTP 状态代码和一组响应标头。

响应代码

注意

如果创建的主题名称包含特殊字符或编码字符（例如，“test?Name=value&”，编码为“test%3FName%3Dvalue%26”），则会生成“(401)未授权”异常。

代码	说明
200	已成功更新主题描述。
401	授权失败。
404	此命名空间中不存在实体。
500	内部错误。

有关状态代码的信息，请参阅 状态和错误代码。

响应标头

响应标头	说明
Content-Type	application/xml;type=entry;charset=utf-8

响应正文

如果此操作成功，响应正文中将返回已更新的主题描述符。