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

CreateSubscriptionOptions interface

表示订阅上的可设置选项

扩展

属性

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

defaultRuleOptions

表示为订阅创建默认规则的选项。

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

消息传送实体的状态。

userMetadata

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

继承属性

abortSignal

可用于中止请求的信号。

onResponse

在执行请求的作时,每次从服务器接收响应时调用的函数。 可以多次调用。

requestOptions

为此作创建和发送 HTTP 请求时使用的选项。

serializerOptions

用于替代序列化/取消序列化行为的选项。

tracingOptions

启用跟踪时使用的选项。

属性详细信息

autoDeleteOnIdle

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

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

autoDeleteOnIdle?: string

属性值

string

availabilityStatus

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

availabilityStatus?: 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

defaultRuleOptions

表示为订阅创建默认规则的选项。

defaultRuleOptions?: { action?: SqlRuleAction, filter?: CorrelationRuleFilter | SqlRuleFilter, name: string }

属性值

{ action?: SqlRuleAction, filter?: CorrelationRuleFilter | SqlRuleFilter, name: 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

属性值

userMetadata

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

userMetadata?: string

属性值

string

继承属性详细信息

abortSignal

可用于中止请求的信号。

abortSignal?: AbortSignalLike

属性值

继承自 OperationOptions.abortSignal

onResponse

在执行请求的作时,每次从服务器接收响应时调用的函数。 可以多次调用。

onResponse?: RawResponseCallback

属性值

继承自OperationOptions.onResponse

requestOptions

为此作创建和发送 HTTP 请求时使用的选项。

requestOptions?: OperationRequestOptions

属性值

继承自 operationOptions.requestOptions

serializerOptions

用于替代序列化/取消序列化行为的选项。

serializerOptions?: SerializerOptions

属性值

继承自OperationOptions.serializerOptions

tracingOptions

启用跟踪时使用的选项。

tracingOptions?: OperationTracingOptions

属性值

继承自OperationOptions.tracingOptions