你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
SubscriptionProperties interface
表示 updateSubscription 的输入。
属性
auto |
删除实体之前的最大空闲时间。 这是以 ISO-8601 持续时间格式(例如 1 分钟为“PT1M”)指定的,“PT5S”为 5 秒。 ISO-8601 持续时间格式的详细信息:https://en.wikipedia.org/wiki/ISO_8601#Durations |
availability |
消息传送实体的可用性状态。 |
dead |
确定服务总线如何处理在订阅的筛选器评估期间导致异常的消息。 如果该值设置为 true,导致异常的消息将移动到订阅的死信子队列。 否则,将放弃它。 默认情况下,此参数设置为 true,允许用户有机会调查异常的原因。 它可能发生在格式不正确的消息或有关邮件格式的筛选器中做出的一些错误假设。 仅在创建主题时设置。 |
dead |
如果启用消息且消息过期,服务总线会将消息从队列移到订阅的死信子队列中。 如果禁用,将从订阅的主队列中永久删除消息。 仅在创建订阅时设置。 |
default |
确定消息在订阅中的生存时间。 根据是否启用了死信,其 TTL 已过期的消息将被移动到订阅的关联 DeadLtterQueue 或永久删除。 这是以 ISO-8601 持续时间格式(例如 1 分钟为“PT1M”)指定的,“PT5S”为 5 秒。 ISO-8601 持续时间格式的详细信息:https://en.wikipedia.org/wiki/ISO_8601#Durations |
enable |
指定是否应允许批处理作。 |
forward |
要转发死信消息的队列或主题的绝对 URL 或主题的名称。
例如,绝对 URL 输入的格式为 |
forward |
要转发消息的队列或主题的绝对 URL 或名称。
例如,绝对 URL 输入的格式为 |
lock |
默认锁持续时间应用于未定义锁定持续时间的订阅。 (如果启用了会话,则此锁定持续时间适用于会话,不适用于消息。 这是以 ISO-8601 持续时间格式(例如 1 分钟为“PT1M”)指定的,“PT5S”为 5 秒。 ISO-8601 持续时间格式的详细信息:https://en.wikipedia.org/wiki/ISO_8601#Durations |
max |
消息的最大传递计数,如果消息仍未解决,则移动到死信子队列。 |
requires |
如果设置为 true,则订阅将识别会话,并且仅支持 SessionReceiver。 REST 不支持会话感知订阅。 仅在创建订阅时设置。 |
status | 消息传送实体的状态。 |
subscription |
订阅的名称 |
topic |
主题的名称 |
user |
用户提供了与订阅关联的元数据信息。 用于指定文本内容,例如标记、标签等。值不得超过以 utf-8 编码的 1024 字节。 |
属性详细信息
autoDeleteOnIdle
删除实体之前的最大空闲时间。 这是以 ISO-8601 持续时间格式(例如 1 分钟为“PT1M”)指定的,“PT5S”为 5 秒。
ISO-8601 持续时间格式的详细信息:https://en.wikipedia.org/wiki/ISO_8601#Durations
autoDeleteOnIdle: string
属性值
string
availabilityStatus
deadLetteringOnFilterEvaluationExceptions
确定服务总线如何处理在订阅的筛选器评估期间导致异常的消息。 如果该值设置为 true,导致异常的消息将移动到订阅的死信子队列。 否则,将放弃它。 默认情况下,此参数设置为 true,允许用户有机会调查异常的原因。 它可能发生在格式不正确的消息或有关邮件格式的筛选器中做出的一些错误假设。 仅在创建主题时设置。
deadLetteringOnFilterEvaluationExceptions: boolean
属性值
boolean
deadLetteringOnMessageExpiration
如果启用消息且消息过期,服务总线会将消息从队列移到订阅的死信子队列中。 如果禁用,将从订阅的主队列中永久删除消息。 仅在创建订阅时设置。
deadLetteringOnMessageExpiration: boolean
属性值
boolean
defaultMessageTimeToLive
确定消息在订阅中的生存时间。 根据是否启用了死信,其 TTL 已过期的消息将被移动到订阅的关联 DeadLtterQueue 或永久删除。 这是以 ISO-8601 持续时间格式(例如 1 分钟为“PT1M”)指定的,“PT5S”为 5 秒。
ISO-8601 持续时间格式的详细信息:https://en.wikipedia.org/wiki/ISO_8601#Durations
defaultMessageTimeToLive: string
属性值
string
enableBatchedOperations
指定是否应允许批处理作。
enableBatchedOperations: boolean
属性值
boolean
forwardDeadLetteredMessagesTo
要转发死信消息的队列或主题的绝对 URL 或主题的名称。
例如,绝对 URL 输入的格式为 sb://<your-service-bus-namespace-endpoint>/<queue-or-topic-name>
forwardDeadLetteredMessagesTo?: string
属性值
string
forwardTo
要转发消息的队列或主题的绝对 URL 或名称。
例如,绝对 URL 输入的格式为 sb://<your-service-bus-namespace-endpoint>/<queue-or-topic-name>
forwardTo?: string
属性值
string
lockDuration
默认锁持续时间应用于未定义锁定持续时间的订阅。 (如果启用了会话,则此锁定持续时间适用于会话,不适用于消息。
这是以 ISO-8601 持续时间格式(例如 1 分钟为“PT1M”)指定的,“PT5S”为 5 秒。
ISO-8601 持续时间格式的详细信息:https://en.wikipedia.org/wiki/ISO_8601#Durations
lockDuration: string
属性值
string
maxDeliveryCount
消息的最大传递计数,如果消息仍未解决,则移动到死信子队列。
maxDeliveryCount: number
属性值
number
requiresSession
如果设置为 true,则订阅将识别会话,并且仅支持 SessionReceiver。 REST 不支持会话感知订阅。 仅在创建订阅时设置。
requiresSession: boolean
属性值
boolean
status
subscriptionName
订阅的名称
subscriptionName: string
属性值
string
topicName
主题的名称
topicName: string
属性值
string
userMetadata
用户提供了与订阅关联的元数据信息。 用于指定文本内容,例如标记、标签等。值不得超过以 utf-8 编码的 1024 字节。
userMetadata?: string
属性值
string