你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
ManagementClient.CreateSubscriptionAsync 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
重载
| CreateSubscriptionAsync(String, String, CancellationToken) |
使用给定名称在服务命名空间中的主题内创建新订阅。 |
| CreateSubscriptionAsync(SubscriptionDescription, RuleDescription, CancellationToken) |
使用提供的默认规则在主题中创建新订阅。 |
| CreateSubscriptionAsync(SubscriptionDescription, CancellationToken) |
使用给定名称在服务命名空间中的主题内创建新订阅。 |
CreateSubscriptionAsync(String, String, CancellationToken)
- Source:
- ManagementClient.cs
使用给定名称在服务命名空间中的主题内创建新订阅。
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)
- Source:
- ManagementClient.cs
使用提供的默认规则在主题中创建新订阅。
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)
- Source:
- ManagementClient.cs
使用给定名称在服务命名空间中的主题内创建新订阅。
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) 用于创建具有不同筛选器的订阅。
