Поделиться через


az iot ops broker listener port

Note

This reference is part of the azure-iot-ops extension for the Azure CLI (version 2.62.0 or higher). Расширение будет автоматически устанавливаться при первом запуске команды порта прослушивателя брокера az iot ops . Learn more about extensions.

Операции порта прослушивателя посредника Mqtt.

Команды

Имя Описание Тип Состояние
az iot ops broker listener port add

Добавьте конфигурацию tcp-порта в службу прослушивателя посредника mqtt.

Extension GA
az iot ops broker listener port remove

Удалите конфигурацию tcp-порта из службы прослушивателя посредника mqtt.

Extension GA

az iot ops broker listener port add

Добавьте конфигурацию tcp-порта в службу прослушивателя посредника mqtt.

Это операция добавления или замены (порта). Если целевой ресурс прослушивателя не существует, команда создаст ее.

az iot ops broker listener port add --instance
                                    --listener
                                    --port
                                    --resource-group
                                    [--authn-ref]
                                    [--authz-ref]
                                    [--broker]
                                    [--nodeport]
                                    [--protocol {Mqtt, WebSockets}]
                                    [--service-name]
                                    [--service-type {ClusterIp, LoadBalancer, NodePort}]
                                    [--show-config {false, true}]
                                    [--tls-duration]
                                    [--tls-issuer-ref]
                                    [--tls-key-algo {Ec256, Ec384, Ec521, Ed25519, Rsa2048, Rsa4096, Rsa8192}]
                                    [--tls-key-rotation {Always, Never}]
                                    [--tls-man-secret-ref]
                                    [--tls-renew-before]
                                    [--tls-san-dns]
                                    [--tls-san-ip]
                                    [--tls-secret-name]

Примеры

Добавьте конфигурацию порта в прослушиватель IP-адресов кластера по умолчанию с помощью порта 8883 и ресурса authn.

az iot ops broker listener port add --port 8883 --authn authn --listener default --in myinstance -g mygroup

Создайте прослушиватель с подсистемой балансировки нагрузки типа службы с помощью конфигурации порта, принимающей tcp-подключения через порт 1883 без утгц или authn.

az iot ops broker listener port add --port 1883 --listener newlistener --in myinstance -g mygroup

Добавьте конфигурацию порта в существующий прослушиватель с использованием основных параметров авто tls в порту 8883 с authn.

az iot ops broker listener port add --port 8883 --authn authn --tls-issuer-ref issuer=azure-iot-operations-aio-certificate-issuer kind=ClusterIssuer --listener newlistener --in myinstance -g mygroup

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

--instance -i

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

--listener -n

Listener name.

--port

Порт службы прослушивателя.

--resource-group -g

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

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--authn-ref

Ссылка на проверку подлинности (имя).

Свойство Значение
Parameter group: Auth Arguments
--authz-ref

Ссылка на авторизацию (имя).

Свойство Значение
Parameter group: Auth Arguments
--broker -b

Broker name.

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

Служба прослушивателя предоставляет статический порт по IP-адресу каждого узла. Имеет значение только в том случае, если этот порт связан с прослушивателем NodePort.

Свойство Значение
Parameter group: Node Port Arguments
--protocol

Протокол, используемый для клиентских подключений.

Свойство Значение
Допустимые значения: Mqtt, WebSockets
--service-name

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

--service-type

Тип службы Kubernetes прослушивателя. Используется, когда целевой прослушиватель не существует.

Свойство Значение
Default value: LoadBalancer
Допустимые значения: ClusterIp, LoadBalancer, NodePort
--show-config

Отображение созданной конфигурации ресурса вместо вызова API с ним.

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

Время существования сертификата. Необходимо указать время. Формат длительности (h|m|s). Например, 240h в течение 240 часов и 45 м в течение 45 минут.

Свойство Значение
Parameter group: TLS Auto Arguments
--tls-issuer-ref

Справочник издателя Cert-manager. Формат — это пары "ключ=значение", разделенные пробелами. Поддерживаются следующие ключи: group, kindname. kind и name обязательны, хотя group имеет значение по умолчанию "cert-manager.io".

Свойство Значение
Parameter group: TLS Auto Arguments
--tls-key-algo

Алгоритм закрытого ключа.

Свойство Значение
Parameter group: TLS Auto Arguments
Допустимые значения: Ec256, Ec384, Ec521, Ed25519, Rsa2048, Rsa4096, Rsa8192
--tls-key-rotation

Политика смены закрытых ключей Cert-manager.

Свойство Значение
Parameter group: TLS Auto Arguments
Допустимые значения: Always, Never
--tls-man-secret-ref

Секрет, содержащий сертификат клиента X.509. Это ссылка на секрет с помощью идентификации имени, а не самого секрета.

Свойство Значение
Parameter group: TLS Manual Arguments
--tls-renew-before

Когда начнется продление сертификата. Необходимо указать время Go. Формат длительности (h|m|s). Например, 240h в течение 240 часов и 45 м в течение 45 минут.

Свойство Значение
Parameter group: TLS Auto Arguments
--tls-san-dns

Альтернативные имена субъектов DNS для сертификата. Используйте разделенные пробелами значения.

Свойство Значение
Parameter group: TLS Auto Arguments
--tls-san-ip

Альтернативные имена субъектов IP-адресов для сертификата. Используйте разделенные пробелами значения.

Свойство Значение
Parameter group: TLS Auto Arguments
--tls-secret-name

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

Свойство Значение
Parameter group: TLS Auto Arguments
Глобальные параметры
--debug

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

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

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

--only-show-errors

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

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

Output format.

Свойство Значение
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 listener port remove

Удалите конфигурацию tcp-порта из службы прослушивателя посредника mqtt.

Если tcp-порты не будут существовать после удаления команды, удалят ресурс прослушивателя.

az iot ops broker listener port remove --instance
                                       --listener
                                       --port
                                       --resource-group
                                       [--broker]
                                       [--yes {false, true}]

Примеры

Удалите tcp-порт 1883 из прослушивателя. Прослушиватель будет удален, если порты не остаются.

az iot ops broker listener port remove --port 1883 --listener mylistener --in myinstance -g mygroup

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

--instance -i

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

--listener -n

Listener name.

--port

Порт службы прослушивателя.

--resource-group -g

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

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--broker -b

Broker name.

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

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

Свойство Значение
Допустимые значения: false, true
Глобальные параметры
--debug

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

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

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

--only-show-errors

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

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

Output format.

Свойство Значение
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