az iot ops broker authz

Note

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

Управление авторизацией брокера Mqtt.

Команды

Имя	Описание	Тип	Состояние
az iot ops broker authz apply	Создайте или замените ресурс авторизации брокера mqtt.	Extension	GA
az iot ops broker authz delete	Удалите ресурс авторизации брокера mqtt.	Extension	GA
az iot ops broker authz list	Вывод списка ресурсов авторизации брокера mqtt, связанных с брокером.	Extension	GA
az iot ops broker authz show	Отображение сведений о ресурсе авторизации брокера mqtt.	Extension	GA

az iot ops broker authz apply

Создайте или замените ресурс авторизации брокера mqtt.

Пример формата файла конфигурации выглядит следующим образом:

{
    "authorizationPolicies": {
        "cache": "Enabled",
        "rules": [
            {
                "principals": {
                    "clientIds": [
                        "temperature-sensor",
                        "humidity-sensor"
                    ],
                    "attributes": [
                        {
                            "city": "seattle",
                            "organization": "contoso"
                        }
                    ]
                },
                "brokerResources": [
                    {
                        "method": "Connect"
                    },
                    {
                        "method": "Publish",
                        "topics": [
                            "/telemetry/{principal.clientId}",
                            "/telemetry/{principal.attributes.organization}"
                        ]
                    },
                    {
                        "method": "Subscribe",
                        "topics": [
                            "/commands/{principal.attributes.organization}"
                        ]
                    }
                ]
            }
        ]
    }
}

При использовании с применением приведенного выше содержимого будет создан или заменен целевой ресурс авторизации, настроенный одним правилом authz.

az iot ops broker authz apply --config-file
                              --instance
                              --name
                              --resource-group
                              [--acquire-policy-token]
                              [--broker]
                              [--change-reference]

Примеры

Создайте или замените ресурс авторизации для брокера по умолчанию с помощью файла конфигурации.

az iot ops broker authz apply -n authz --in myinstance -g myresourcegroup --config-file /path/to/authz/config.json

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

--config-file

Путь к файлу конфигурации с свойствами ресурса в формате JSON. Файл конфигурации должен содержать объект со свойствами, совместимыми с представлением ресурса ARM. Объект коррелирует непосредственно с "свойствами:{}" ресурса ARM.

Свойство	Значение
Группа параметров:	Config Arguments

--instance -i

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

--name -n

Имя ресурса авторизации брокера Mqtt.

--resource-group -g

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

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

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

--acquire-policy-token

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

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

--broker -b

Имя брокера Mqtt.

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

--change-reference

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

Свойство	Значение
Группа параметров:	Global Policy 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

az iot ops broker authz delete

Удалите ресурс авторизации брокера mqtt.

az iot ops broker authz delete --instance
                               --name
                               --resource-group
                               [--acquire-policy-token]
                               [--broker]
                               [--change-reference]
                               [--yes {false, true}]

Примеры

Удалите ресурс авторизации брокера mqtt с именем authz, связанный с брокером по умолчанию.

az iot ops broker authz delete -n authz --in myinstance -g myresourcegroup

Аналогично предыдущему примеру, но пропускает запрос на подтверждение.

az iot ops broker authz delete -n authz --in myinstance -g myresourcegroup -y

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

--instance -i

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

--name -n

Имя ресурса авторизации брокера Mqtt.

--resource-group -g

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

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

--acquire-policy-token

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

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

--broker -b

Имя брокера Mqtt.

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

--change-reference

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

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

--yes -y

Подтвердите [y]es без запроса. Полезно для сценариев CI и автоматизации.

Свойство	Значение
Допустимые значения:	false, true

Глобальные параметры

--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

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

az iot ops broker authz list

Вывод списка ресурсов авторизации брокера mqtt, связанных с брокером.

az iot ops broker authz list --instance
                             --resource-group
                             [--broker]

Примеры

Перечислите все ресурсы авторизации брокера mqtt, связанные с брокером по умолчанию.

az iot ops broker authz list --in myinstance -g myresourcegroup

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

--instance -i

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

--resource-group -g

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

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

--broker -b

Имя брокера Mqtt.

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

Глобальные параметры

--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

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

az iot ops broker authz show

Отображение сведений о ресурсе авторизации брокера mqtt.

az iot ops broker authz show --instance
                             --name
                             --resource-group
                             [--broker]

Примеры

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

az iot ops broker authz show -n authz --in myinstance -g myresourcegroup

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

--instance -i

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

--name -n

Имя ресурса авторизации брокера Mqtt.

--resource-group -g

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

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

--broker -b

Имя брокера Mqtt.

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

Глобальные параметры

--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

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

Обратная связь

Были ли сведения на этой странице полезными?