az iot ops broker persist

Note

Эта ссылка является частью расширения azure-iot-ops для Azure CLI (версия 2.70.0 или более поздней). Расширение будет автоматически устанавливаться при первом запуске команды az iot ops broker. Подробнее о расширениях.

Управление сохраняемостью дисков брокера Mqtt.

Команды

Имя Описание Тип Состояние
az iot ops broker persist update

Обновите параметры сохраняемости диска брокера mqtt.

 Extension GA

az iot ops broker persist update

Обновите параметры сохраняемости диска брокера mqtt.

Обновление сохраняемости диска зависит от включения во время создания брокера. Установка режима сохраняемости компонента брокера приведет к сбросу конфигурации.

az iot ops broker persist update --instance
                                 --resource-group
                                 [--acquire-policy-token]
                                 [--change-reference]
                                 [--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"

Настройте сохраняемость очереди подписчиков для определенных идентификаторов клиентов.

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

Имя экземпляра операций Интернета вещей.

--resource-group -g

Имя группы ресурсов. Вы можете настроить группу по умолчанию с помощью az configure --defaults group=<name>.

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--acquire-policy-token

Автоматическое получение маркера Политика Azure для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--change-reference

Связанный идентификатор ссылки на изменение для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--disable-dynamic

Отключите динамическую сохраняемость. Поддерживаемые значения включают: StateStore, "сохранить", "подписчикQueue".

Свойство Значение
Группа параметров: Dynamic Persistence Arguments
--name -n

Имя брокера.

Свойство Значение
Default value: default
--persist-mode

Настройте режим сохраняемости диска для хранилища состояний, сохранения сообщений и очередей подписчиков. Формат — это пары "ключ=значение", разделенные пробелами. Поддерживаемые ключи включают: StateStore, "сохранить", "подписчикQueue". Поддерживаемые значения для каждого ключа включают: None, All, Custom. По умолчанию каждый режим имеет значение min Custom с включенной динамической сохраняемостью. Этот параметр можно использовать один или несколько раз.

--retain-topics

Разделенный пробелами список разделов, в которых сохраненные сообщения будут сохранены на диске. Поддерживаются подстановочные знаки # и +.

Свойство Значение
Группа параметров: Retained Messages Arguments
--state-store-bin-keys

Разделенный пробелами список двоичных ключей в формате в кодировке base-64, который будет сохранен на диске. Можно использовать несколько раз, когда каждое вхождение добавляется в коллекцию политик хранилища состояний.

Свойство Значение
Группа параметров: State Store Arguments
--state-store-glob-keys

Разделенный пробелами список ключей, соответствующих шаблонам глобов, которые будут сохранены на диске. Можно использовать несколько раз, когда каждое вхождение добавляется в коллекцию политик хранилища состояний.

Свойство Значение
Группа параметров: State Store Arguments
--state-store-str-keys

Разделенный пробелами список строковых ключей, которые будут сохранены на диске. Строковые ключи используются для точного сопоставления, например, если ключ содержит символы, которые могут быть сопоставлены в противном случае как шаблон (*, ?, [0-9]). Можно использовать несколько раз, когда каждое вхождение добавляется в коллекцию политик хранилища состояний.

Свойство Значение
Группа параметров: State Store Arguments
--subscriber-client-ids

Разделенный пробелами список идентификаторов клиента подписчика, поддерживаемых подстановочным знаком * .

Свойство Значение
Группа параметров: Subscriber Queue Arguments
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False