ServiceBusAdministrationClient.CreateSubscriptionAsync メソッド

定義

オーバーロード

CreateSubscriptionAsync(CreateSubscriptionOptions, CancellationToken)

指定した名前を使用して、サービス名前空間のトピック内に新しいサブスクリプションを作成します。

CreateSubscriptionAsync(CreateSubscriptionOptions, CreateRuleOptions, CancellationToken)

指定された既定の規則を使用して、トピック内に新しいサブスクリプションを作成します。

CreateSubscriptionAsync(String, String, CancellationToken)

指定した名前を使用して、サービス名前空間のトピック内に新しいサブスクリプションを作成します。

CreateSubscriptionAsync(CreateSubscriptionOptions, CancellationToken)

ソース:
ServiceBusAdministrationClient.cs
ソース:
ServiceBusAdministrationClient.cs

指定した名前を使用して、サービス名前空間のトピック内に新しいサブスクリプションを作成します。

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

パラメーター

options
CreateSubscriptionOptions

SubscriptionProperties新しいサブスクリプションを作成する属性を記述する オブジェクト。

cancellationToken
CancellationToken

操作を取り消す要求を通知する省略可能 CancellationToken な インスタンス。

戻り値

SubscriptionProperties新しく作成されたサブスクリプションの 。

例外

同じ名前のサブスクリプションが同じサービス名前空間の下に存在します。

操作がタイムアウトします。タイムアウト期間は、 クラスを 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 設定されます。

注釈

サブスクリプションが既に存在する場合は をスローします。 既定では、このサブスクリプションに対して "パススルー" フィルターが作成されます。つまり、すべてのメッセージがこのサブスクリプションに移動できるようにします。 フィルターの名前は で DefaultRuleName表されます。 CreateSubscriptionAsync(CreateSubscriptionOptions, CreateRuleOptions, CancellationToken) 別のフィルターを使用してサブスクリプションを作成する場合。

適用対象

CreateSubscriptionAsync(CreateSubscriptionOptions, CreateRuleOptions, CancellationToken)

ソース:
ServiceBusAdministrationClient.cs
ソース:
ServiceBusAdministrationClient.cs

指定された既定の規則を使用して、トピック内に新しいサブスクリプションを作成します。

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

パラメーター

options
CreateSubscriptionOptions

SubscriptionProperties新しいサブスクリプションを作成する属性を記述する オブジェクト。

rule
CreateRuleOptions

既定の RuleProperties 規則を記述する オブジェクト。 null の場合は、名前 DefaultRuleName を持つパススルー フィルターが作成されます。

cancellationToken
CancellationToken

操作を取り消す要求を通知する省略可能 CancellationToken な インスタンス。

戻り値

SubscriptionProperties新しく作成されたサブスクリプションの 。

例外

同じ名前のサブスクリプションが同じサービス名前空間の下に存在します。

操作がタイムアウトします。タイムアウト期間は、 クラスを 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 設定されます。

注釈

サブスクリプションが既に存在する場合は をスローします。

適用対象

CreateSubscriptionAsync(String, String, CancellationToken)

ソース:
ServiceBusAdministrationClient.cs
ソース:
ServiceBusAdministrationClient.cs

指定した名前を使用して、サービス名前空間のトピック内に新しいサブスクリプションを作成します。

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

パラメーター

topicName
String

サービス名前空間のベース アドレスを基準としたトピックの名前。

subscriptionName
String

サブスクリプションの名前です。

cancellationToken
CancellationToken

操作を取り消す要求を通知する省略可能 CancellationToken な インスタンス。

戻り値

SubscriptionProperties新しく作成されたサブスクリプションの 。

例外

同じ名前のサブスクリプションが同じサービス名前空間の下に存在します。

操作がタイムアウトします。タイムアウト期間は、 クラスを 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 設定されます。

注釈

サブスクリプションが既に存在する場合は をスローします。 SubscriptionProperties サブスクリプションの説明の既定値。 既定では、このサブスクリプションに対して "パススルー" フィルターが作成されます。つまり、すべてのメッセージがこのサブスクリプションに移動できるようにします。 フィルターの名前は で DefaultRuleName表されます。 CreateSubscriptionAsync(CreateSubscriptionOptions, CreateRuleOptions, CancellationToken) 別のフィルターを使用してサブスクリプションを作成する場合。

適用対象