你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
ServiceBusAdministrationClient.CreateRuleAsync 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
将新规则添加到给定主题下的订阅。
public virtual System.Threading.Tasks.Task<Azure.Response<Azure.Messaging.ServiceBus.Administration.RuleProperties>> CreateRuleAsync (string topicName, string subscriptionName, Azure.Messaging.ServiceBus.Administration.CreateRuleOptions options, System.Threading.CancellationToken cancellationToken = default);
abstract member CreateRuleAsync : string * string * Azure.Messaging.ServiceBus.Administration.CreateRuleOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Messaging.ServiceBus.Administration.RuleProperties>>
override this.CreateRuleAsync : string * string * Azure.Messaging.ServiceBus.Administration.CreateRuleOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Messaging.ServiceBus.Administration.RuleProperties>>
Public Overridable Function CreateRuleAsync (topicName As String, subscriptionName As String, options As CreateRuleOptions, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of RuleProperties))
参数
- topicName
- String
相对于服务命名空间基址的主题名称。
- subscriptionName
- String
订阅的名称。
- options
- CreateRuleOptions
一个 CreateRuleOptions 对象,该对象描述与消息匹配并对其执行操作的属性。
- cancellationToken
- CancellationToken
一个可选 CancellationToken 实例,用于向请求发出取消操作的信号。
返回
RuleProperties 最近创建的规则的 。
例外
同一服务命名空间下存在同一名称的订阅。
操作超时。超时期限是通过 ServiceBusAdministrationClientOptions 类初始化的, (请参阅 retry 属性) 。 如果超时值相对较低,则可能需要增加超时值以避免此异常。
说明中的指定大小不受支持,或者已达到允许的最大配额。 必须指定支持的大小值之一、删除现有实体或增加配额大小。
服务器繁忙。 在重试操作之前,应等待。
主题名称、订阅名称或 options
实例为 null。
主题或订阅名称超出了允许的最大长度。
主题或订阅名称否则无效。
权限不足,无法执行此操作。 应检查,以确保拥有ServiceBusAdministrationClient执行此操作所需的声明。 https://docs.microsoft.com/azure/service-bus-messaging/service-bus-sas#rights-required-for-service-bus-operations
- 订阅下存在同名的规则。 在这种情况下, Reason 将设置为 MessagingEntityAlreadyExists 。
- 操作超时。在这种情况下, Reason 将设置为 ServiceTimeout 。
- 实体的指定大小不受支持,或者已达到允许的最大配额。 必须指定支持的大小值之一、删除现有实体或增加配额大小。 在这种情况下,失败原因将设置为 QuotaExceeded 。
- 服务器繁忙。 在重试操作之前,应等待。 在这种情况下,失败原因将设置为 ServiceBusy 。
- 发生内部错误或意外异常。 在这种情况下,失败原因将设置为 GeneralError 。