通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

az iot ops broker persist

Note

此参考是 Azure CLI（版本 2.67.0 或更高版本）的 azure-iot-ops 扩展的一部分。 该扩展将在首次运行 az iot ops broker persist 命令时自动安装。 了解更多关于扩展的信息。

Mqtt 中转站磁盘持久性管理。

命令

名称 说明 类型 Status
az iot ops broker persist update

更新 mqtt broker 的磁盘持久性设置。

 Extension GA

az iot ops broker persist update

更新 mqtt broker 的磁盘持久性设置。

更新磁盘持久性取决于在代理创建时启用。 设置中转站组件的持久性模式将重置其配置。

az iot ops broker persist update --instance
                                 --resource-group
                                 [--disable-dynamic]
                                 [--name]
                                 [--persist-mode]
                                 [--retain-topics]
                                 [--state-store-bin-keys]
                                 [--state-store-glob-keys]
                                 [--state-store-str-keys]
                                 [--subscriber-client-ids]

示例

更新订阅服务器消息队列的持久性模式，保留主题和状态存储。

az iot ops broker persist update --in myinstance -g myresourcegroup --persist-mode subscriberQueue=All retain=All stateStore=All

更新用于保留消息的自定义持久性策略。

az iot ops broker persist update --in myinstance -g myresourcegroup --persist-mode retain=Custom --retain-topics "sensor1" "factory/#" "groundfloor/+/temperature"

使用多个密钥组设置状态存储持久性，包括字符串、模式和二进制（base64 编码）密钥。

az iot ops broker persist update --in myinstance -g myresourcegroup --persist-mode stateStore=Custom --state-store-str-keys "device-001" "device-002" --state-store-glob-keys "sensors/*" --state-store-bin-keys "bXlrZXkx" "bXlrZXky"

为特定客户端 ID 配置订阅服务器队列持久性。

az iot ops broker persist update --in myinstance -g myresourcegroup --persist-mode subscriberQueue=Custom --subscriber-client-ids "factory-client-*" "sensor-gateway-01"

具有多个持久性模式、状态存储密钥分组和自定义代理的动态设置的高级配置。

az iot ops broker persist update --in myinstance -g myresourcegroup --name default --persist-mode retain=Custom stateStore=Custom subscriberQueue=All --retain-topics "alerts/#" "diagnostics/#" --state-store-str-keys "user:admin" "session:active" --state-store-str-keys "config:database" "config:security" --state-store-glob-keys "logs/*" "backups/*" --disable-dynamic stateStore

必需参数

--instance -i

IoT 操作实例名称。

--resource-group -g

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

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

--disable-dynamic

禁用动态持久性。 支持的值包括：“stateStore”、“retain”、“subscriberQueue”。

属性 值
参数组: Dynamic Persistence Arguments
--name -n

代理名称。

属性 值
默认值: default
--persist-mode

为状态存储、保留消息和订阅服务器队列配置磁盘持久性模式。 格式是空格分隔的键=值对。 支持的密钥包括：“stateStore”、“retain”、“subscriberQueue”。 每个键支持的值包括：“None”、“All”、“Custom”。 默认情况下，每个模式都设置为启用动态持久性的自定义。 此选项可以一次或多次使用。

--retain-topics

将保留消息保存到磁盘的主题的空格分隔列表。 支持通配符 # 和 +。

属性 值
参数组: Retained Messages Arguments
--state-store-bin-keys

将保留到磁盘的 base-64 编码格式的二进制键的空间分隔列表。 可以多次使用，其中每个匹配项都追加到状态存储策略集合。

属性 值
参数组: State Store Arguments
--state-store-glob-keys

将保存到磁盘的 glob 样式模式匹配键的空间分隔列表。 可以多次使用，其中每个匹配项都追加到状态存储策略集合。

属性 值
参数组: State Store Arguments
--state-store-str-keys

将持久保存到磁盘的字符串键的空格分隔列表。 字符串键用于执行完全匹配，例如，当键包含可能以模式 （*， ？， [0-9] 的形式匹配的字符时）。 可以多次使用，其中每个匹配项都追加到状态存储策略集合。

属性 值
参数组: State Store Arguments
--subscriber-client-ids

订阅者客户端 ID 的空格分隔列表，通配符 * 受支持。

属性 值
参数组: Subscriber Queue Arguments
全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

属性 值
默认值: False
--output -o

输出格式。

属性 值
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

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

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性 值
默认值: False