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

ServiceBusAdministrationClient.CreateQueueAsync 方法

定义

重载

CreateQueueAsync(CreateQueueOptions, CancellationToken)

使用给定名称在服务命名空间中创建一个新队列。

CreateQueueAsync(String, CancellationToken)

使用给定名称在服务命名空间中创建一个新队列。

CreateQueueAsync(CreateQueueOptions, CancellationToken)

Source:
ServiceBusAdministrationClient.cs
Source:
ServiceBusAdministrationClient.cs

使用给定名称在服务命名空间中创建一个新队列。

public virtual System.Threading.Tasks.Task<Azure.Response<Azure.Messaging.ServiceBus.Administration.QueueProperties>> CreateQueueAsync (Azure.Messaging.ServiceBus.Administration.CreateQueueOptions options, System.Threading.CancellationToken cancellationToken = default);
abstract member CreateQueueAsync : Azure.Messaging.ServiceBus.Administration.CreateQueueOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Messaging.ServiceBus.Administration.QueueProperties>>
override this.CreateQueueAsync : Azure.Messaging.ServiceBus.Administration.CreateQueueOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Messaging.ServiceBus.Administration.QueueProperties>>
Public Overridable Function CreateQueueAsync (options As CreateQueueOptions, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of QueueProperties))

参数

options
CreateQueueOptions

一个 CreateQueueOptions 对象,该对象描述将用于创建新队列的属性。

cancellationToken
CancellationToken

一个可选 CancellationToken 实例,用于发出取消操作的请求信号。

返回

QueueProperties新创建的队列的 。

例外

同一服务命名空间下存在同一名称的实体。

操作超时。超时期限是通过 ServiceBusAdministrationClientOptions 类初始化的 (请参阅 retry 属性) 。 如果超时值相对较低,可能需要增加超时值以避免此异常。

说明中的指定大小不受支持,或者已达到允许的最大配额。 必须指定支持的大小值之一、删除现有实体或增加配额大小。

服务器繁忙。 在重试操作之前,应等待。

实例 options 为 null。

  • 同一服务命名空间下存在同一名称的队列。 在这种情况下, Reason 将设置为 MessagingEntityAlreadyExists
  • 操作超时。在这种情况下, Reason 将设置为 ServiceTimeout
  • 实体的指定大小不受支持,或者已达到允许的最大配额。 必须指定支持的大小值之一、删除现有实体或增加配额大小。 在这种情况下,失败原因将设置为 QuotaExceeded
  • 服务器繁忙。 在重试操作之前,应等待。 在这种情况下,失败原因将设置为 ServiceBusy
  • 发生内部错误或意外异常。 在这种情况下,失败原因将设置为 GeneralError

注解

如果队列已存在,则引发 。

适用于

CreateQueueAsync(String, CancellationToken)

Source:
ServiceBusAdministrationClient.cs
Source:
ServiceBusAdministrationClient.cs

使用给定名称在服务命名空间中创建一个新队列。

public virtual System.Threading.Tasks.Task<Azure.Response<Azure.Messaging.ServiceBus.Administration.QueueProperties>> CreateQueueAsync (string name, System.Threading.CancellationToken cancellationToken = default);
abstract member CreateQueueAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Messaging.ServiceBus.Administration.QueueProperties>>
override this.CreateQueueAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Messaging.ServiceBus.Administration.QueueProperties>>
Public Overridable Function CreateQueueAsync (name As String, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of QueueProperties))

参数

name
String

相对于服务命名空间基址的队列名称。

cancellationToken
CancellationToken

一个可选 CancellationToken 实例,用于发出取消操作的请求信号。

返回

QueueProperties新创建的队列的 。

例外

同一服务命名空间下存在同一名称的实体。

操作超时。超时期限是通过 ServiceBusAdministrationClientOptions 类初始化的 (请参阅 retry 属性) 。 如果超时值相对较低,可能需要增加超时值以避免此异常。

说明中的指定大小不受支持,或者已达到允许的最大配额。 必须指定支持的大小值之一、删除现有实体或增加配额大小。

服务器繁忙。 在重试操作之前,应等待。

队列名称为 null 或空。

队列名称超出了允许的最大长度。

否则,队列名称无效。

  • 同一服务命名空间下存在同一名称的队列。 在这种情况下, Reason 将设置为 MessagingEntityAlreadyExists
  • 操作超时。在这种情况下, Reason 将设置为 ServiceTimeout
  • 实体的指定大小不受支持,或者已达到允许的最大配额。 必须指定支持的大小值之一、删除现有实体或增加配额大小。 在这种情况下,失败原因将设置为 QuotaExceeded
  • 服务器繁忙。 在重试操作之前,应等待。 在这种情况下,失败原因将设置为 ServiceBusy
  • 发生内部错误或意外异常。 在这种情况下,失败原因将设置为 GeneralError

注解

如果队列已存在,则引发 。 QueueProperties 表示队列属性的默认值。

适用于