你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
ServiceBusAdministrationClient.CreateQueueAsync 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
重载
| CreateQueueAsync(CreateQueueOptions, CancellationToken) |
使用给定名称在服务命名空间中创建一个新队列。 |
| CreateQueueAsync(String, CancellationToken) |
使用给定名称在服务命名空间中创建一个新队列。 |
CreateQueueAsync(CreateQueueOptions, CancellationToken)
使用给定名称在服务命名空间中创建一个新队列。
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。
权限不足，无法执行此操作。 应检查，以确保具有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 。
注解
如果队列已存在，则引发 。
适用于
CreateQueueAsync(String, CancellationToken)
使用给定名称在服务命名空间中创建一个新队列。
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 或空。
队列名称超出了允许的最大长度。
否则，队列名称无效。
权限不足，无法执行此操作。 应检查，以确保具有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 。
注解
如果队列已存在，则引发 。 QueueProperties 表示队列属性的默认值。
适用于
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈