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 キュー プロパティの既定値の場合は 。
適用対象
Azure SDK for .NET