ManagementClient.CreateSubscriptionAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
| CreateSubscriptionAsync(String, String, CancellationToken) |
指定した名前のサービス名前空間内のトピック内に新しいサブスクリプションを作成します。 |
| CreateSubscriptionAsync(SubscriptionDescription, RuleDescription, CancellationToken) |
指定された既定のルールを使用して、トピック内に新しいサブスクリプションを作成します。 |
| CreateSubscriptionAsync(SubscriptionDescription, CancellationToken) |
指定した名前のサービス名前空間内のトピック内に新しいサブスクリプションを作成します。 |
CreateSubscriptionAsync(String, String, CancellationToken)
指定した名前のサービス名前空間内のトピック内に新しいサブスクリプションを作成します。
public virtual System.Threading.Tasks.Task<Microsoft.Azure.ServiceBus.Management.SubscriptionDescription> CreateSubscriptionAsync (string topicPath, string subscriptionName, System.Threading.CancellationToken cancellationToken = default);abstract member CreateSubscriptionAsync : string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.ServiceBus.Management.SubscriptionDescription>
override this.CreateSubscriptionAsync : string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.ServiceBus.Management.SubscriptionDescription>Public Overridable Function CreateSubscriptionAsync (topicPath As String, subscriptionName As String, Optional cancellationToken As CancellationToken = Nothing) As Task(Of SubscriptionDescription)パラメーター
- topicPath
- String
サービス名前空間のベース アドレスに対するトピックの相対パス。
- subscriptionName
- String
サブスクリプションの名前です。
- cancellationToken
- CancellationToken
戻り値
SubscriptionDescription新しく作成されたサブスクリプションの 。
例外
トピックパスまたはサブスクリプション名が null または空です。
の topicPath 長さは 260 文字より大きいか subscriptionName 、50 文字を超えています。
同じ名前のサブスクリプションが、同じサービス名前空間の下に存在します。
操作がタイムアウトします。タイムアウト期間は、 クラスを ServiceBusConnection 介して初期化されます。 タイムアウト値が比較的小さい場合は、この例外を回避するために、タイムアウトの値を増やす必要がある場合があります。
この操作を実行するための十分なアクセス許可がありません。 チェックして、この操作をManagementClient実行するための正しいTokenProvider資格情報があることを確認する必要があります。
説明の指定されたサイズがサポートされていないか、許容される最大クォータに達しました。 サポートされているサイズ値のいずれかを指定するか、既存のエンティティを削除するか、クォータ サイズを増やす必要があります。
サーバーがビジーです。 操作を再試行する前に、待機する必要があります。
内部エラーまたは予期しない例外が発生します。
注釈
サブスクリプションが既に存在する場合は をスローします。 SubscriptionDescription サブスクリプション プロパティの既定値の場合は 。 既定では、このサブスクリプションに対して "パススルー" フィルターが作成されます。つまり、すべてのメッセージがこのサブスクリプションに移動できるようになります。 フィルターの名前は で DefaultRuleName表されます。 CreateSubscriptionAsync(SubscriptionDescription, RuleDescription, CancellationToken) 別のフィルターを使用してサブスクリプションを作成する場合は 。
適用対象
CreateSubscriptionAsync(SubscriptionDescription, RuleDescription, CancellationToken)
指定された既定のルールを使用して、トピック内に新しいサブスクリプションを作成します。
public virtual System.Threading.Tasks.Task<Microsoft.Azure.ServiceBus.Management.SubscriptionDescription> CreateSubscriptionAsync (Microsoft.Azure.ServiceBus.Management.SubscriptionDescription subscriptionDescription, Microsoft.Azure.ServiceBus.RuleDescription defaultRule, System.Threading.CancellationToken cancellationToken = default);abstract member CreateSubscriptionAsync : Microsoft.Azure.ServiceBus.Management.SubscriptionDescription * Microsoft.Azure.ServiceBus.RuleDescription * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.ServiceBus.Management.SubscriptionDescription>
override this.CreateSubscriptionAsync : Microsoft.Azure.ServiceBus.Management.SubscriptionDescription * Microsoft.Azure.ServiceBus.RuleDescription * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.ServiceBus.Management.SubscriptionDescription>Public Overridable Function CreateSubscriptionAsync (subscriptionDescription As SubscriptionDescription, defaultRule As RuleDescription, Optional cancellationToken As CancellationToken = Nothing) As Task(Of SubscriptionDescription)パラメーター
- subscriptionDescription
- SubscriptionDescription
SubscriptionDescription新しいサブスクリプションを作成する属性を記述する オブジェクト。
- defaultRule
- RuleDescription
既定の RuleDescription 規則を記述する オブジェクト。 null の場合は、名前 DefaultRuleName を持つパススルー フィルターが作成されます。
- cancellationToken
- CancellationToken
戻り値
SubscriptionDescription新しく作成されたサブスクリプションの 。
例外
サブスクリプションの説明が null です。
同じ名前のサブスクリプションが、同じサービス名前空間の下に存在します。
操作がタイムアウトします。タイムアウト期間は、 クラスを ServiceBusConnection 介して初期化されます。 タイムアウト値が比較的小さい場合は、この例外を回避するために、タイムアウトの値を増やす必要がある場合があります。
この操作を実行するための十分なアクセス許可がありません。 チェックして、この操作をManagementClient実行するための正しいTokenProvider資格情報があることを確認する必要があります。
説明の指定されたサイズがサポートされていないか、許容される最大クォータに達しました。 サポートされているサイズ値のいずれかを指定するか、既存のエンティティを削除するか、クォータ サイズを増やす必要があります。
サーバーがビジーです。 操作を再試行する前に、待機する必要があります。
内部エラーまたは予期しない例外が発生します。
注釈
サブスクリプションが既に存在する場合は をスローします。
適用対象
CreateSubscriptionAsync(SubscriptionDescription, CancellationToken)
指定した名前のサービス名前空間内のトピック内に新しいサブスクリプションを作成します。
public virtual System.Threading.Tasks.Task<Microsoft.Azure.ServiceBus.Management.SubscriptionDescription> CreateSubscriptionAsync (Microsoft.Azure.ServiceBus.Management.SubscriptionDescription subscriptionDescription, System.Threading.CancellationToken cancellationToken = default);abstract member CreateSubscriptionAsync : Microsoft.Azure.ServiceBus.Management.SubscriptionDescription * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.ServiceBus.Management.SubscriptionDescription>
override this.CreateSubscriptionAsync : Microsoft.Azure.ServiceBus.Management.SubscriptionDescription * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.ServiceBus.Management.SubscriptionDescription>Public Overridable Function CreateSubscriptionAsync (subscriptionDescription As SubscriptionDescription, Optional cancellationToken As CancellationToken = Nothing) As Task(Of SubscriptionDescription)パラメーター
- subscriptionDescription
- SubscriptionDescription
SubscriptionDescription新しいサブスクリプションを作成する属性を記述する オブジェクト。
- cancellationToken
- CancellationToken
戻り値
SubscriptionDescription新しく作成されたサブスクリプションの 。
例外
サブスクリプションの説明が null です。
同じ名前のサブスクリプションが、同じサービス名前空間の下に存在します。
操作がタイムアウトします。タイムアウト期間は、 クラスを ServiceBusConnection 介して初期化されます。 タイムアウト値が比較的小さい場合は、この例外を回避するために、タイムアウトの値を増やす必要がある場合があります。
この操作を実行するための十分なアクセス許可がありません。 チェックして、この操作をManagementClient実行するための正しいTokenProvider資格情報があることを確認する必要があります。
説明の指定されたサイズがサポートされていないか、許容される最大クォータに達しました。 サポートされているサイズ値のいずれかを指定するか、既存のエンティティを削除するか、クォータ サイズを増やす必要があります。
サーバーがビジーです。 操作を再試行する前に、待機する必要があります。
内部エラーまたは予期しない例外が発生します。
注釈
サブスクリプションが既に存在する場合は をスローします。 既定では、このサブスクリプションに対して "パススルー" フィルターが作成されます。つまり、すべてのメッセージがこのサブスクリプションに移動できるようになります。 フィルターの名前は で DefaultRuleName表されます。 CreateSubscriptionAsync(SubscriptionDescription, RuleDescription, CancellationToken) 別のフィルターを使用してサブスクリプションを作成する場合は 。
適用対象
Azure SDK for .NET