您现在访问的是微软AZURE全球版技术文档网站,若需要访问由世纪互联运营的MICROSOFT AZURE中国区技术文档网站,请访问 https://docs.azure.cn.

az servicebus topic

管理 Azure 服务总线主题和授权规则。

命令

az servicebus topic authorization-rule

管理 Azure 服务总线主题授权规则。

az servicebus topic authorization-rule create

为给定的服务总线主题创建授权规则。

az servicebus topic authorization-rule delete

删除给定服务总线主题的授权规则。

az servicebus topic authorization-rule keys

管理 Azure 授权规则密钥,服务总线主题。

az servicebus topic authorization-rule keys list

列出主题的授权规则的密钥和服务总线字符串。

az servicebus topic authorization-rule keys renew

重新生成主题的授权规则的服务总线密钥。

az servicebus topic authorization-rule list

按服务总线主题显示授权规则的列表。

az servicebus topic authorization-rule show

显示给定服务总线主题的授权规则的详细信息。

az servicebus topic authorization-rule update

为给定的服务总线主题创建授权规则。

az servicebus topic create

创建服务总线主题。

az servicebus topic delete

删除服务总线主题。

az servicebus topic list

按服务总线命名空间列出主题。

az servicebus topic show

显示服务总线主题的详细信息。

az servicebus topic subscription

管理 Azure 服务总线订阅。

az servicebus topic subscription create

创建 "

az servicebus topic subscription delete

删除服务总线订阅。

az servicebus topic subscription list

按服务总线主题列出订阅。

az servicebus topic subscription rule

管理 Azure 服务总线规则。

az servicebus topic subscription rule create

为订阅创建 ServiceBus 规则。

az servicebus topic subscription rule delete

删除 ServiceBus 规则。

az servicebus topic subscription rule list

按订阅列出 ServiceBus 规则。

az servicebus topic subscription rule show

显示 ServiceBus 规则详细信息。

az servicebus topic subscription rule update

更新订阅的 ServiceBus 规则。

az servicebus topic subscription show

显示服务总线订阅详细信息。

az servicebus topic subscription update

更新该更新程序订阅。

az servicebus topic update

更新服务总线主题。

az servicebus topic create

创建服务总线主题。

az servicebus topic create --name
                           --namespace-name
                           --resource-group
                           [--auto-delete-on-idle]
                           [--default-message-time-to-live]
                           [--duplicate-detection-history-time-window]
                           [--enable-batched-operations {false, true}]
                           [--enable-duplicate-detection {false, true}]
                           [--enable-express {false, true}]
                           [--enable-ordering {false, true}]
                           [--enable-partitioning {false, true}]
                           [--max-size {1024, 10240, 2048, 20480, 3072, 4096, 40960, 5120, 81920}]
                           [--status {Active, Disabled, SendDisabled}]
                           [--subscription]

示例

新建服务总线主题

az servicebus topic create --resource-group myresourcegroup --namespace-name mynamespace --name mytopic

必需参数

--name -n

主题的名称。

--namespace-name

命名空间的名称。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

可选参数

--auto-delete-on-idle

针对空闲时间间隔的 ISO 8601 timespan 或持续时间格式,在此时间段后将自动删除该主题。 最短持续时间为 5 分钟。

--default-message-time-to-live

ISO 8601 或默认消息时间跨度到活动值的持续时间格式。 这是消息过期之前的持续时间,从将消息发送到服务总线开始。 这是在消息本身未设置 TimeToLive 时使用的默认值。

--duplicate-detection-history-time-window

用于定义重复检测历史记录的持续时间的结构的 ISO 8601 timespan 或 duration 时间格式。 默认值为 10 分钟。

--enable-batched-operations

允许服务器端的批处理操作。

接受的值: false, true
--enable-duplicate-detection

一个布尔值,指示此主题是否需要重复检测。

接受的值: false, true
--enable-express

指示是否启用了 Express 实体的布尔值。 快速主题在将消息写入永久性存储之前暂时将其保存在内存中。

接受的值: false, true
--enable-ordering

一个布尔值,该值指示主题是否支持排序。

接受的值: false, true
--enable-partitioning

指示是否已启用跨多个消息代理进行分区的主题的布尔值。

接受的值: false, true
--max-size

主题的最大大小(mb),这是为主题分配的内存的大小。 默认值为 1024。 标准 SKU 的最大值为5120,对于高级版 sku 为81920。

接受的值: 1024, 10240, 2048, 20480, 3072, 4096, 40960, 5120, 81920
--status

枚举消息实体状态的可能值。

接受的值: Active, Disabled, SendDisabled
--subscription

订阅的名称或 ID。 您可以使用配置默认订阅 az account set -s NAME_OR_ID

az servicebus topic delete

删除服务总线主题。

az servicebus topic delete [--ids]
                           [--name]
                           [--namespace-name]
                           [--resource-group]
                           [--subscription]

示例

删除服务总线主题

az servicebus topic delete --resource-group myresourcegroup --namespace-name mynamespace --name mytopic

可选参数

--ids

一个或多个资源 Id (以空格分隔) 。 它应该是包含 "资源 Id" 参数的所有信息的完整资源 ID。 应提供--id 或其他 "资源 Id" 参数。

--name -n

主题的名称。

--namespace-name

命名空间的名称。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--subscription

订阅的名称或 ID。 您可以使用配置默认订阅 az account set -s NAME_OR_ID

az servicebus topic list

按服务总线命名空间列出主题。

az servicebus topic list --namespace-name
                         --resource-group
                         [--query-examples]
                         [--skip]
                         [--subscription]
                         [--top]

示例

按命名空间获取主题。

az servicebus topic list --resource-group myresourcegroup --namespace-name mynamespace

必需参数

--namespace-name

命名空间的名称。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

可选参数

--query-examples

建议 JMESPath 字符串。 可以复制其中一个查询,然后将其粘贴在双引号内,以查看结果。 您可以添加一个或多个位置关键字,以便我们可以根据这些关键字提供建议。

--skip

仅当上一个操作返回了部分结果时,才使用 Skip。 如果以前的响应包含 nextLink 元素,则 nextLink 元素的值将包括 skip 参数,该参数指定要用于后续调用的起点。

--subscription

订阅的名称或 ID。 您可以使用配置默认订阅 az account set -s NAME_OR_ID

--top

可用于将结果数限制为最近的 N 个 usageDetails。

az servicebus topic show

显示服务总线主题的详细信息。

az servicebus topic show [--ids]
                         [--name]
                         [--namespace-name]
                         [--query-examples]
                         [--resource-group]
                         [--subscription]

示例

显示主题的详细信息。

az servicebus topic show --resource-group myresourcegroup --namespace-name mynamespace --name mytopic

可选参数

--ids

一个或多个资源 Id (以空格分隔) 。 它应该是包含 "资源 Id" 参数的所有信息的完整资源 ID。 应提供--id 或其他 "资源 Id" 参数。

--name -n

主题的名称。

--namespace-name

命名空间的名称。

--query-examples

建议 JMESPath 字符串。 可以复制其中一个查询,然后将其粘贴在双引号内,以查看结果。 您可以添加一个或多个位置关键字,以便我们可以根据这些关键字提供建议。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--subscription

订阅的名称或 ID。 您可以使用配置默认订阅 az account set -s NAME_OR_ID

az servicebus topic update

更新服务总线主题。

az servicebus topic update [--add]
                           [--auto-delete-on-idle]
                           [--default-message-time-to-live]
                           [--duplicate-detection-history-time-window]
                           [--enable-batched-operations {false, true}]
                           [--enable-duplicate-detection {false, true}]
                           [--enable-express {false, true}]
                           [--enable-ordering {false, true}]
                           [--enable-partitioning {false, true}]
                           [--force-string]
                           [--ids]
                           [--max-size {1024, 10240, 2048, 20480, 3072, 4096, 40960, 5120, 81920}]
                           [--name]
                           [--namespace-name]
                           [--remove]
                           [--resource-group]
                           [--set]
                           [--status {Active, Disabled, SendDisabled}]
                           [--subscription]

示例

更新现有服务总线主题。

az servicebus topic update --resource-group myresourcegroup --namespace-name mynamespace --name mytopic --enable-ordering True

更新 (自动生成的服务总线主题)

az servicebus topic update --auto-delete-on-idle PT3M --name mytopic --namespace-name mynamespace --resource-group myresourcegroup

更新 (自动生成的服务总线主题)

az servicebus topic update --enable-batched-operations true --name mytopic --namespace-name mynamespace --resource-group myresourcegroup

可选参数

--add

通过指定路径和键值对,将对象添加到对象列表中。 示例:--添加 listProperty <键 = 值、字符串或 JSON 字符串>。

--auto-delete-on-idle

针对空闲时间间隔的 ISO 8601 timespan 或持续时间格式,在此时间段后将自动删除该主题。 最短持续时间为 5 分钟。

--default-message-time-to-live

ISO 8601 或默认消息时间跨度到活动值的持续时间格式。 这是消息过期之前的持续时间,从将消息发送到服务总线开始。 这是在消息本身未设置 TimeToLive 时使用的默认值。

--duplicate-detection-history-time-window

用于定义重复检测历史记录的持续时间的结构的 ISO 8601 timespan 或 duration 时间格式。 默认值为 10 分钟。

--enable-batched-operations

允许服务器端的批处理操作。

接受的值: false, true
--enable-duplicate-detection

一个布尔值,指示此主题是否需要重复检测。

接受的值: false, true
--enable-express

指示是否启用了 Express 实体的布尔值。 快速主题在将消息写入永久性存储之前暂时将其保存在内存中。

接受的值: false, true
--enable-ordering

一个布尔值,该值指示主题是否支持排序。

接受的值: false, true
--enable-partitioning

指示是否已启用跨多个消息代理进行分区的主题的布尔值。

接受的值: false, true
--force-string

使用 "set" 或 "add" 时,保留字符串文本,而不是尝试转换为 JSON。

--ids

一个或多个资源 Id (以空格分隔) 。 它应该是包含 "资源 Id" 参数的所有信息的完整资源 ID。 应提供--id 或其他 "资源 Id" 参数。

--max-size

主题的最大大小(mb),这是为主题分配的内存的大小。 默认值为 1024。 标准 SKU 的最大值为5120,对于高级版 sku 为81920。

接受的值: 1024, 10240, 2048, 20480, 3072, 4096, 40960, 5120, 81920
--name -n

主题的名称。

--namespace-name

命名空间的名称。

--remove

从列表中删除属性或元素。 示例:--remove property. list 或--Remove propertyToRemove。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--set

通过指定要设置的属性路径和值来更新对象。 示例:--set property1. property2 =.

--status

枚举消息实体状态的可能值。

接受的值: Active, Disabled, SendDisabled
--subscription

订阅的名称或 ID。 您可以使用配置默认订阅 az account set -s NAME_OR_ID