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

SubscriptionProperties interface

包:

@azure/service-bus

表示 updateSubscription 的输入。

属性

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

属性详细信息

autoDeleteOnIdle

删除实体之前的最大空闲时间。 这是以 ISO-8601 持续时间格式（例如 1 分钟为“PT1M”）指定的，“PT5S”为 5 秒。

ISO-8601 持续时间格式的详细信息：https://en.wikipedia.org/wiki/ISO_8601#Durations

autoDeleteOnIdle: string

属性值

string

availabilityStatus

消息传送实体的可用性状态。

availabilityStatus?: EntityAvailabilityStatus

属性值

EntityAvailabilityStatus

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

消息传送实体的状态。

status: EntityStatus

属性值

EntityStatus

subscriptionName

订阅的名称

subscriptionName: string

属性值

string

topicName

主题的名称

topicName: string

属性值

string

userMetadata

用户提供了与订阅关联的元数据信息。 用于指定文本内容，例如标记、标签等。值不得超过以 utf-8 编码的 1024 字节。

userMetadata?: string

属性值

string