你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
ServiceBusAdministrationClient.GetRuleAsync 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
从服务命名空间检索规则。
public virtual System.Threading.Tasks.Task<Azure.Response<Azure.Messaging.ServiceBus.Administration.RuleProperties>> GetRuleAsync (string topicName, string subscriptionName, string ruleName, System.Threading.CancellationToken cancellationToken = default);abstract member GetRuleAsync : string * string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Messaging.ServiceBus.Administration.RuleProperties>>
override this.GetRuleAsync : string * string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Messaging.ServiceBus.Administration.RuleProperties>>Public Overridable Function GetRuleAsync (topicName As String, subscriptionName As String, ruleName As String, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of RuleProperties))参数
- topicName
- String
相对于服务总线命名空间的主题的名称。
- subscriptionName
- String
规则所属的订阅名称。
- ruleName
- String
要检索的规则的名称。
- cancellationToken
- CancellationToken
一个可选 CancellationToken 实例，用于发出取消操作的请求信号。
返回
RuleProperties 包含有关规则的信息。
例外
操作超时。超时期限是通过 ServiceBusAdministrationClientOptions 类初始化的 (请参阅 retry 属性) 。 如果超时值相对较低，可能需要增加超时值以避免此异常。
具有此名称的主题/订阅/规则不存在。
服务器繁忙。 在重试操作之前，应等待。
主题、订阅或规则名称为 null 或空。
主题、订阅或规则名称超出了允许的最大长度。
否则，主题、订阅或规则名称无效。
权限不足，无法执行此操作。 应检查，以确保具有ServiceBusAdministrationClient执行此操作所需的声明。 https://docs.microsoft.com/azure/service-bus-messaging/service-bus-sas#rights-required-for-service-bus-operations
- 找不到指定的实体。 在这种情况下， Reason 将设置为 MessagingEntityNotFound 。
- 操作超时。在这种情况下， Reason 将设置为 ServiceTimeout 。
- 服务器繁忙。 在重试操作之前，应等待。 在这种情况下，失败原因将设置为 ServiceBusy 。
- 发生内部错误或意外异常。 在这种情况下，失败原因将设置为 GeneralError 。
注解
注意 - 筛选器和操作参数中仅对以下数据类型进行反序列化 - string、int、long、bool、double、DateTime。 其他数据类型将返回其字符串值。
