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

ServiceBusAdministrationClient class

所有操作返回解析为具有相关输出的对象的承诺。 这些对象还有一个名为 _response 的属性,如果要访问服务的直接响应,可以使用该属性。

扩展

构造函数

ServiceBusAdministrationClient(string, ServiceBusAdministrationClientOptions)

初始化 ServiceBusAdministrationClient 类的新实例。

ServiceBusAdministrationClient(string, TokenCredential | NamedKeyCredential, ServiceBusAdministrationClientOptions)

继承属性

pipeline

此客户端用于发出请求的管道

方法

createQueue(string, CreateQueueOptions)

创建具有给定名称的队列,并使用给定的选项进行配置

createRule(string, string, string, CorrelationRuleFilter | SqlRuleFilter, OperationOptions)

创建具有给定名称的规则,并使用给定的选项进行配置。

createRule(string, string, string, CorrelationRuleFilter | SqlRuleFilter, SqlRuleAction, OperationOptions)

创建具有给定名称的规则,并使用给定的选项进行配置。

createSubscription(string, string, CreateSubscriptionOptions)

使用给定选项配置具有给定名称的订阅

createTopic(string, CreateTopicOptions)

创建具有给定名称的主题,并使用给定选项进行配置

deleteQueue(string, OperationOptions)

删除队列。

deleteRule(string, string, string, OperationOptions)

删除规则。

deleteSubscription(string, string, OperationOptions)

删除订阅。

deleteTopic(string, OperationOptions)

删除主题。

getNamespaceProperties(OperationOptions)

返回一个 对象,该对象表示与服务总线命名空间相关的元数据。

getQueue(string, OperationOptions)

返回表示 Queue 及其属性的 对象。 如果要获取队列运行时信息(如消息计数详细信息),请使用 getQueueRuntimeProperties API。

getQueueRuntimeProperties(string, OperationOptions)

返回表示队列运行时信息(如消息计数详细信息)的 对象。

getRule(string, string, string, OperationOptions)

返回一个 对象,该对象表示具有给定名称的 Rule 及其所有属性。

getSubscription(string, string, OperationOptions)

返回一个对象,该对象表示订阅及其属性。 如果要获取订阅运行时信息(如消息计数详细信息),请使用 getSubscriptionRuntimeProperties API。

getSubscriptionRuntimeProperties(string, string, OperationOptions)

返回一个 对象,该对象表示订阅运行时信息(如消息计数详细信息)。

getTopic(string, OperationOptions)

返回表示 Topic 及其属性的 对象。 如果要获取订阅计数详细信息等主题运行时信息,请使用 getTopicRuntimeProperties API。

getTopicRuntimeProperties(string, OperationOptions)

返回一个 对象,该对象表示主题运行时信息(如订阅计数)。

listQueues(OperationOptions)

返回一个异步可迭代器,用于列出所有队列。

.byPage () 返回一个异步可迭代器,用于列出页面中的队列。

listQueuesRuntimeProperties(OperationOptions)

返回一个异步可迭代迭代器,用于列出队列的运行时信息。

.byPage () 返回一个异步可迭代器,用于列出页面中队列的运行时信息。

listRules(string, string, OperationOptions)

返回一个异步可迭代迭代器,以列出指定订阅下的所有规则。

.byPage () 返回一个异步可迭代器,用于列出页面中的规则。

listSubscriptions(string, OperationOptions)

返回一个异步可迭代迭代器,以列出指定主题下的所有订阅。

.byPage () 返回一个异步可迭代器,以列出页面中的订阅。

listSubscriptionsRuntimeProperties(string, OperationOptions)

返回一个异步可迭代迭代器,用于列出指定主题下订阅的运行时信息。

.byPage () 返回一个异步可迭代器,用于列出页面中订阅的运行时信息。

listTopics(OperationOptions)

返回一个异步可迭代器以列出所有主题。

.byPage () 返回一个异步可迭代器以列出页面中的主题。

listTopicsRuntimeProperties(OperationOptions)

返回一个异步可迭代迭代器,用于列出主题的运行时信息。

.byPage () 返回一个异步迭代器,用于列出页面中主题的运行时信息。

queueExists(string, OperationOptions)

检查给定队列是否存在。

ruleExists(string, string, string, OperationOptions)

检查给定规则是否存在。

subscriptionExists(string, string, OperationOptions)

检查主题中是否存在给定订阅。

topicExists(string, OperationOptions)

检查给定主题是否存在。

updateQueue(WithResponse<QueueProperties>, OperationOptions)

根据提供的队列属性汇报队列。 必须设置所有队列属性,即使实际上只有其中一部分可更新。 因此,建议的流是使用 的 getQueue()输出,更新其中所需的属性,然后将修改的对象传递给 updateQueue()

无法更新的属性在 接口中 QueueProperties 标记为只读。

updateRule(string, string, WithResponse<RuleProperties>, OperationOptions)

根据给定选项,按给定名称汇报规则的属性。 必须设置所有规则属性,即使其中一个属性正在更新。 因此,建议的流是使用 的 getRule()输出,更新其中所需的属性,然后将修改的对象传递给 updateRule()

updateSubscription(WithResponse<SubscriptionProperties>, OperationOptions)

根据提供的订阅属性汇报订阅。 必须设置所有订阅属性,即使实际上只有其中一部分属性可更新。 因此,建议的流是使用 的 getSubscription()输出,更新其中所需的属性,然后将修改的对象传递给 updateSubscription()

无法更新的属性在 接口中 SubscriptionProperties 标记为只读。

updateTopic(WithResponse<TopicProperties>, OperationOptions)

根据提供的主题属性汇报主题。 必须设置所有主题属性,即使实际上只有其中一部分属性是可更新的。 因此,建议的流是使用 的 getTopic()输出,更新其中所需的属性,然后将修改的对象传递给 updateTopic()

无法更新的属性在 接口中 TopicProperties 标记为只读。

继承的方法

sendOperationRequest<T>(OperationArguments, OperationSpec)

发送使用提供的 OperationSpec 填充的 HTTP 请求。

sendRequest(PipelineRequest)

发送提供的 httpRequest。

构造函数详细信息

ServiceBusAdministrationClient(string, ServiceBusAdministrationClientOptions)

初始化 ServiceBusAdministrationClient 类的新实例。

new ServiceBusAdministrationClient(connectionString: string, options?: ServiceBusAdministrationClientOptions)

参数

connectionString

string

客户端连接到 Azure 所需的连接字符串。

options
ServiceBusAdministrationClientOptions

PipelineOptions

ServiceBusAdministrationClient(string, TokenCredential | NamedKeyCredential, ServiceBusAdministrationClientOptions)

new ServiceBusAdministrationClient(fullyQualifiedNamespace: string, credential: TokenCredential | NamedKeyCredential, options?: ServiceBusAdministrationClientOptions)

参数

fullyQualifiedNamespace

string

服务总线实例的完全限定命名空间,可能类似于 .servicebus.windows.net。

credential

TokenCredential | NamedKeyCredential

客户端用于获取令牌的凭据对象,用于对Azure 服务总线的连接进行身份验证。 有关创建凭据,请参阅@azure/标识。 如果针对 AAD 使用自己的接口实现 TokenCredential ,请将服务总线的“作用域”设置为 ["https://servicebus.azure.net//user_impersonation"] 以获取相应的令牌。 AzureNamedKeyCredential如果要在不使用连接字符串的情况下传入 和 SharedAccessKeySharedAccessKeyName请使用 from @azure/core-auth。 这些字段分别映射到 name 中的 AzureNamedKeyCredentialkey 字段。

options
ServiceBusAdministrationClientOptions

PipelineOptions

继承属性详细信息

pipeline

此客户端用于发出请求的管道

pipeline: Pipeline

属性值

继承自 ServiceClient.pipeline

方法详细信息

createQueue(string, CreateQueueOptions)

创建具有给定名称的队列,并使用给定的选项进行配置

function createQueue(queueName: string, options?: CreateQueueOptions): Promise<WithResponse<QueueProperties>>

参数

queueName

string

options
CreateQueueOptions

配置要创建的队列的选项 (例如,可以将队列配置为支持分区或会话) 以及可用于中止、跟踪和控制 HTTP 请求上其他配置的操作选项。

以下是此操作中可能预期的错误

返回

createRule(string, string, string, CorrelationRuleFilter | SqlRuleFilter, OperationOptions)

创建具有给定名称的规则,并使用给定的选项进行配置。

function createRule(topicName: string, subscriptionName: string, ruleName: string, ruleFilter: CorrelationRuleFilter | SqlRuleFilter, operationOptions?: OperationOptions): Promise<WithResponse<RuleProperties>>

参数

topicName

string

subscriptionName

string

ruleName

string

ruleFilter

CorrelationRuleFilter | SqlRuleFilter

定义规则计算的筛选器表达式。

operationOptions
OperationOptions

可用于中止、跟踪和控制 HTTP 请求上其他配置的选项。

以下是此操作中可能预期的错误

返回

createRule(string, string, string, CorrelationRuleFilter | SqlRuleFilter, SqlRuleAction, OperationOptions)

创建具有给定名称的规则,并使用给定的选项进行配置。

function createRule(topicName: string, subscriptionName: string, ruleName: string, ruleFilter: CorrelationRuleFilter | SqlRuleFilter, ruleAction: SqlRuleAction, operationOptions?: OperationOptions): Promise<WithResponse<RuleProperties>>

参数

topicName

string

subscriptionName

string

ruleName

string

ruleFilter

CorrelationRuleFilter | SqlRuleFilter

定义规则计算的筛选器表达式。

ruleAction
SqlRuleAction

如果应用关联的筛选器,则可以对消息执行 SQL 类似表达式。

operationOptions
OperationOptions

可用于中止、跟踪和控制 HTTP 请求上其他配置的选项。

以下是此操作中可能预期的错误

返回

createSubscription(string, string, CreateSubscriptionOptions)

使用给定选项配置具有给定名称的订阅

function createSubscription(topicName: string, subscriptionName: string, options?: CreateSubscriptionOptions): Promise<WithResponse<SubscriptionProperties>>

参数

topicName

string

subscriptionName

string

options
CreateSubscriptionOptions

用于配置要创建的订阅的选项 (例如,可以将订阅配置为支持分区或会话) 以及可用于中止、跟踪和控制 HTTP 请求上其他配置的操作选项。

以下是此操作中可能预期的错误

返回

createTopic(string, CreateTopicOptions)

创建具有给定名称的主题,并使用给定选项进行配置

function createTopic(topicName: string, options?: CreateTopicOptions): Promise<WithResponse<TopicProperties>>

参数

topicName

string

options
CreateTopicOptions

用于配置正在创建的主题 (例如,可以将主题配置为支持分区) 以及可用于中止、跟踪和控制 HTTP 请求上其他配置的操作选项。

以下是此操作中可能预期的错误

返回

deleteQueue(string, OperationOptions)

删除队列。

function deleteQueue(queueName: string, operationOptions?: OperationOptions): Promise<{ _response: HttpResponse }>

参数

queueName

string

operationOptions
OperationOptions

可用于中止、跟踪和控制 HTTP 请求上其他配置的选项。

以下是此操作中可能预期的错误

返回

Promise<{ _response: HttpResponse }>

deleteRule(string, string, string, OperationOptions)

删除规则。

function deleteRule(topicName: string, subscriptionName: string, ruleName: string, operationOptions?: OperationOptions): Promise<{ _response: HttpResponse }>

参数

topicName

string

subscriptionName

string

ruleName

string

operationOptions
OperationOptions

可用于中止、跟踪和控制 HTTP 请求上其他配置的选项。

以下是此操作中可能预期的错误

返回

Promise<{ _response: HttpResponse }>

deleteSubscription(string, string, OperationOptions)

删除订阅。

function deleteSubscription(topicName: string, subscriptionName: string, operationOptions?: OperationOptions): Promise<{ _response: HttpResponse }>

参数

topicName

string

subscriptionName

string

operationOptions
OperationOptions

可用于中止、跟踪和控制 HTTP 请求上其他配置的选项。

以下是此操作中可能预期的错误

返回

Promise<{ _response: HttpResponse }>

deleteTopic(string, OperationOptions)

删除主题。

function deleteTopic(topicName: string, operationOptions?: OperationOptions): Promise<{ _response: HttpResponse }>

参数

topicName

string

operationOptions
OperationOptions

可用于中止、跟踪和控制 HTTP 请求上其他配置的选项。

以下是此操作中可能预期的错误

返回

Promise<{ _response: HttpResponse }>

getNamespaceProperties(OperationOptions)

返回一个 对象,该对象表示与服务总线命名空间相关的元数据。

function getNamespaceProperties(operationOptions?: OperationOptions): Promise<WithResponse<NamespaceProperties>>

参数

operationOptions
OperationOptions

可用于中止、跟踪和控制 HTTP 请求上其他配置的选项。

返回

getQueue(string, OperationOptions)

返回表示 Queue 及其属性的 对象。 如果要获取队列运行时信息(如消息计数详细信息),请使用 getQueueRuntimeProperties API。

function getQueue(queueName: string, operationOptions?: OperationOptions): Promise<WithResponse<QueueProperties>>

参数

queueName

string

operationOptions
OperationOptions

可用于中止、跟踪和控制 HTTP 请求上其他配置的选项。

以下是此操作中可能预期的错误

返回

getQueueRuntimeProperties(string, OperationOptions)

返回表示队列运行时信息(如消息计数详细信息)的 对象。

function getQueueRuntimeProperties(queueName: string, operationOptions?: OperationOptions): Promise<WithResponse<QueueRuntimeProperties>>

参数

queueName

string

operationOptions
OperationOptions

可用于中止、跟踪和控制 HTTP 请求上其他配置的选项。

以下是此操作中可能预期的错误

返回

getRule(string, string, string, OperationOptions)

返回一个 对象,该对象表示具有给定名称的 Rule 及其所有属性。

function getRule(topicName: string, subscriptionName: string, ruleName: string, operationOptions?: OperationOptions): Promise<WithResponse<RuleProperties>>

参数

topicName

string

subscriptionName

string

ruleName

string

operationOptions
OperationOptions

可用于中止、跟踪和控制 HTTP 请求上其他配置的选项。

以下是此操作中可能预期的错误

返回

getSubscription(string, string, OperationOptions)

返回一个对象,该对象表示订阅及其属性。 如果要获取订阅运行时信息(如消息计数详细信息),请使用 getSubscriptionRuntimeProperties API。

function getSubscription(topicName: string, subscriptionName: string, operationOptions?: OperationOptions): Promise<WithResponse<SubscriptionProperties>>

参数

topicName

string

subscriptionName

string

operationOptions
OperationOptions

可用于中止、跟踪和控制 HTTP 请求上其他配置的选项。

以下是此操作中可能预期的错误

返回

getSubscriptionRuntimeProperties(string, string, OperationOptions)

返回一个 对象,该对象表示订阅运行时信息(如消息计数详细信息)。

function getSubscriptionRuntimeProperties(topicName: string, subscriptionName: string, operationOptions?: OperationOptions): Promise<WithResponse<SubscriptionRuntimeProperties>>

参数

topicName

string

subscriptionName

string

operationOptions
OperationOptions

可用于中止、跟踪和控制 HTTP 请求上其他配置的选项。

以下是此操作中可能预期的错误

返回

getTopic(string, OperationOptions)

返回表示 Topic 及其属性的 对象。 如果要获取订阅计数详细信息等主题运行时信息,请使用 getTopicRuntimeProperties API。

function getTopic(topicName: string, operationOptions?: OperationOptions): Promise<WithResponse<TopicProperties>>

参数

topicName

string

operationOptions
OperationOptions

可用于中止、跟踪和控制 HTTP 请求上其他配置的选项。

以下是此操作中可能预期的错误

返回

getTopicRuntimeProperties(string, OperationOptions)

返回一个 对象,该对象表示主题运行时信息(如订阅计数)。

function getTopicRuntimeProperties(topicName: string, operationOptions?: OperationOptions): Promise<WithResponse<TopicRuntimeProperties>>

参数

topicName

string

operationOptions
OperationOptions

可用于中止、跟踪和控制 HTTP 请求上其他配置的选项。

以下是此操作中可能预期的错误

返回

listQueues(OperationOptions)

返回一个异步可迭代器,用于列出所有队列。

.byPage () 返回一个异步可迭代器,用于列出页面中的队列。

function listQueues(options?: OperationOptions): PagedAsyncIterableIterator<QueueProperties, EntitiesResponse<QueueProperties>, PageSettings>

参数

返回

支持分页的 asyncIterableIterator。

listQueuesRuntimeProperties(OperationOptions)

返回一个异步可迭代迭代器,用于列出队列的运行时信息。

.byPage () 返回一个异步可迭代器,用于列出页面中队列的运行时信息。

function listQueuesRuntimeProperties(options?: OperationOptions): PagedAsyncIterableIterator<QueueRuntimeProperties, EntitiesResponse<QueueRuntimeProperties>, PageSettings>

参数

返回

支持分页的 asyncIterableIterator。

listRules(string, string, OperationOptions)

返回一个异步可迭代迭代器,以列出指定订阅下的所有规则。

.byPage () 返回一个异步可迭代器,用于列出页面中的规则。

function listRules(topicName: string, subscriptionName: string, options?: OperationOptions): PagedAsyncIterableIterator<RuleProperties, EntitiesResponse<RuleProperties>, PageSettings>

参数

topicName

string

subscriptionName

string

返回

支持分页的 asyncIterableIterator。

listSubscriptions(string, OperationOptions)

返回一个异步可迭代迭代器,以列出指定主题下的所有订阅。

.byPage () 返回一个异步可迭代器,以列出页面中的订阅。

function listSubscriptions(topicName: string, options?: OperationOptions): PagedAsyncIterableIterator<SubscriptionProperties, EntitiesResponse<SubscriptionProperties>, PageSettings>

参数

topicName

string

返回

支持分页的 asyncIterableIterator。

listSubscriptionsRuntimeProperties(string, OperationOptions)

返回一个异步可迭代迭代器,用于列出指定主题下订阅的运行时信息。

.byPage () 返回一个异步可迭代器,用于列出页面中订阅的运行时信息。

function listSubscriptionsRuntimeProperties(topicName: string, options?: OperationOptions): PagedAsyncIterableIterator<SubscriptionRuntimeProperties, EntitiesResponse<SubscriptionRuntimeProperties>, PageSettings>

参数

topicName

string

返回

支持分页的 asyncIterableIterator。

listTopics(OperationOptions)

返回一个异步可迭代器以列出所有主题。

.byPage () 返回一个异步可迭代器以列出页面中的主题。

function listTopics(options?: OperationOptions): PagedAsyncIterableIterator<TopicProperties, EntitiesResponse<TopicProperties>, PageSettings>

参数

返回

支持分页的 asyncIterableIterator。

listTopicsRuntimeProperties(OperationOptions)

返回一个异步可迭代迭代器,用于列出主题的运行时信息。

.byPage () 返回一个异步迭代器,用于列出页面中主题的运行时信息。

function listTopicsRuntimeProperties(options?: OperationOptions): PagedAsyncIterableIterator<TopicRuntimeProperties, EntitiesResponse<TopicRuntimeProperties>, PageSettings>

参数

返回

支持分页的 asyncIterableIterator。

queueExists(string, OperationOptions)

检查给定队列是否存在。

function queueExists(queueName: string, operationOptions?: OperationOptions): Promise<boolean>

参数

queueName

string

operationOptions
OperationOptions

可用于中止、跟踪和控制 HTTP 请求的其他配置的选项。

返回

Promise<boolean>

ruleExists(string, string, string, OperationOptions)

检查给定规则是否存在。

function ruleExists(topicName: string, subscriptionName: string, ruleName: string, operationOptions?: OperationOptions): Promise<boolean>

参数

topicName

string

subscriptionName

string

ruleName

string

operationOptions
OperationOptions

返回

Promise<boolean>

subscriptionExists(string, string, OperationOptions)

检查主题中是否存在给定订阅。

function subscriptionExists(topicName: string, subscriptionName: string, operationOptions?: OperationOptions): Promise<boolean>

参数

topicName

string

subscriptionName

string

operationOptions
OperationOptions

可用于中止、跟踪和控制 HTTP 请求的其他配置的选项。

返回

Promise<boolean>

topicExists(string, OperationOptions)

检查给定主题是否存在。

function topicExists(topicName: string, operationOptions?: OperationOptions): Promise<boolean>

参数

topicName

string

operationOptions
OperationOptions

可用于中止、跟踪和控制 HTTP 请求的其他配置的选项。

返回

Promise<boolean>

updateQueue(WithResponse<QueueProperties>, OperationOptions)

根据提供的队列属性汇报队列。 必须设置所有队列属性,即使实际上只有其中一部分可更新。 因此,建议的流是使用 的 getQueue()输出,更新其中所需的属性,然后将修改的对象传递给 updateQueue()

无法更新的属性在 接口中 QueueProperties 标记为只读。

function updateQueue(queue: WithResponse<QueueProperties>, operationOptions?: OperationOptions): Promise<WithResponse<QueueProperties>>

参数

queue

WithResponse<QueueProperties>

表示队列和原始响应的属性的对象。 requiresSession创建队列后,无法更新 、 requiresDuplicateDetectionenablePartitioningname

operationOptions
OperationOptions

可用于中止、跟踪和控制 HTTP 请求的其他配置的选项。

以下是此操作中预期会出现的错误

返回

updateRule(string, string, WithResponse<RuleProperties>, OperationOptions)

根据给定选项,按给定名称汇报规则的属性。 必须设置所有规则属性,即使其中一个属性正在更新。 因此,建议的流是使用 的 getRule()输出,更新其中所需的属性,然后将修改的对象传递给 updateRule()

function updateRule(topicName: string, subscriptionName: string, rule: WithResponse<RuleProperties>, operationOptions?: OperationOptions): Promise<WithResponse<RuleProperties>>

参数

topicName

string

subscriptionName

string

rule

WithResponse<RuleProperties>

用于配置要更新的规则和原始响应的选项。 例如,可以将筛选器配置为应用于关联的主题/订阅。

operationOptions
OperationOptions

可用于中止、跟踪和控制 HTTP 请求的其他配置的选项。

以下是此操作中预期会出现的错误

返回

updateSubscription(WithResponse<SubscriptionProperties>, OperationOptions)

根据提供的订阅属性汇报订阅。 必须设置所有订阅属性,即使实际上只有其中一部分属性可更新。 因此,建议的流是使用 的 getSubscription()输出,更新其中所需的属性,然后将修改的对象传递给 updateSubscription()

无法更新的属性在 接口中 SubscriptionProperties 标记为只读。

function updateSubscription(subscription: WithResponse<SubscriptionProperties>, operationOptions?: OperationOptions): Promise<WithResponse<SubscriptionProperties>>

参数

subscription

WithResponse<SubscriptionProperties>

表示订阅和原始响应的属性的对象。 subscriptionName创建订阅后,无法更新 、 topicNamerequiresSession

operationOptions
OperationOptions

可用于中止、跟踪和控制 HTTP 请求的其他配置的选项。

以下是此操作中预期会出现的错误

返回

updateTopic(WithResponse<TopicProperties>, OperationOptions)

根据提供的主题属性汇报主题。 必须设置所有主题属性,即使实际上只有其中一部分属性是可更新的。 因此,建议的流是使用 的 getTopic()输出,更新其中所需的属性,然后将修改的对象传递给 updateTopic()

无法更新的属性在 接口中 TopicProperties 标记为只读。

function updateTopic(topic: WithResponse<TopicProperties>, operationOptions?: OperationOptions): Promise<WithResponse<TopicProperties>>

参数

topic

WithResponse<TopicProperties>

表示主题和原始响应的属性的对象。 requiresDuplicateDetection创建主题后,无法更新 、 enablePartitioningname

operationOptions
OperationOptions

可用于中止、跟踪和控制 HTTP 请求的其他配置的选项。

以下是此操作中预期会出现的错误

返回

继承的方法详细信息

sendOperationRequest<T>(OperationArguments, OperationSpec)

发送使用提供的 OperationSpec 填充的 HTTP 请求。

function sendOperationRequest<T>(operationArguments: OperationArguments, operationSpec: OperationSpec): Promise<T>

参数

operationArguments
OperationArguments

将从中填充 HTTP 请求的模板化值的参数。

operationSpec
OperationSpec

用于填充 httpRequest 的 OperationSpec。

返回

Promise<T>

继承自 ServiceClient.sendOperationRequest

sendRequest(PipelineRequest)

发送提供的 httpRequest。

function sendRequest(request: PipelineRequest): Promise<PipelineResponse>

参数

request
PipelineRequest

返回

Promise<PipelineResponse>

继承自 ServiceClient.sendRequest