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). La extensión instalará automáticamente la primera vez que ejecute un comando az iot ops broker listener port . Learn more about extensions.

Operaciones de puerto del agente de escucha del agente mqtt.

Comandos

Nombre	Description	Tipo	Estado
az iot ops broker listener port add	Agregue una configuración de puerto tcp a un servicio de escucha de agente mqtt.	Extension	GA
az iot ops broker listener port remove	Quite una configuración de puerto tcp de un servicio de escucha de agente mqtt.	Extension	GA

az iot ops broker listener port add

Agregue una configuración de puerto tcp a un servicio de escucha de agente mqtt.

Se trata de una operación de adición o reemplazo (puerto). Si el recurso del agente de escucha de destino no existe, el comando lo creará.

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]

Ejemplos

Agregue una configuración de puerto al agente de escucha IP del clúster predeterminado mediante el puerto 8883 y un recurso de autenticación.

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

Cree un nuevo agente de escucha con un equilibrador de carga de tipo de servicio mediante una configuración de puerto que acepte conexiones tcp en el puerto 1883 sin autenticación ni authz.

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

Agregue una configuración de puerto a un agente de escucha existente mediante la configuración básica de tls automático en el puerto 8883 con autenticación.

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

Parámetros requeridos

--instance -i

Nombre de instancia de IoT Operations.

--listener -n

Listener name.

--port

Puerto del servicio de escucha.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

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

--authn-ref

Referencia de autenticación (nombre).

Propiedad	Valor
Parameter group:	Auth Arguments

--authz-ref

Referencia de autorización (nombre).

Propiedad	Valor
Parameter group:	Auth Arguments

--broker -b

Broker name.

Propiedad	Valor
Valor predeterminado:	default

--nodeport

El servicio de escucha expondrá un puerto estático en la dirección IP de cada nodo. Solo es relevante cuando este puerto está asociado a un agente de escucha NodePort.

Propiedad	Valor
Parameter group:	Node Port Arguments

--protocol

Protocolo que se va a usar para las conexiones de cliente.

Propiedad	Valor
Valores aceptados:	Mqtt, WebSockets

--service-name

Nombre del servicio Kubernetes del agente de escucha. Se usa cuando no existe un agente de escucha de destino.

--service-type

Tipo de servicio de Kubernetes del agente de escucha. Se usa cuando no existe un agente de escucha de destino.

Propiedad	Valor
Valor predeterminado:	LoadBalancer
Valores aceptados:	ClusterIp, LoadBalancer, NodePort

--show-config

Mostrar la configuración de recursos generada en lugar de invocar la API con ella.

Propiedad	Valor
Valores aceptados:	false, true

--tls-duration

Duración del certificado. Debe especificarse con una hora. Formato de duración (h|m|s). Por ejemplo, 240h durante 240 horas y 45m durante 45 minutos.

Propiedad	Valor
Parameter group:	TLS Auto Arguments

--tls-issuer-ref

Referencia del emisor del administrador de certificados. El formato es pares clave=valor separados por espacio. Se admiten las siguientes claves: group, kind, name. kind y name son necesarios, mientras group que tiene un valor predeterminado de "cert-manager.io".

Propiedad	Valor
Parameter group:	TLS Auto Arguments

--tls-key-algo

Algoritmo de clave privada.

Propiedad	Valor
Parameter group:	TLS Auto Arguments
Valores aceptados:	Ec256, Ec384, Ec521, Ed25519, Rsa2048, Rsa4096, Rsa8192

--tls-key-rotation

Directiva de rotación de claves privadas de Cert-manager.

Propiedad	Valor
Parameter group:	TLS Auto Arguments
Valores aceptados:	Always, Never

--tls-man-secret-ref

Secreto que contiene un certificado de cliente X.509. Se trata de una referencia al secreto a través de un nombre de identificación, no el propio secreto.

Propiedad	Valor
Parameter group:	TLS Manual Arguments

--tls-renew-before

Cuándo empezar a renovar el certificado. Debe especificarse con una hora de go. Formato de duración (h|m|s). Por ejemplo, 240h durante 240 horas y 45m durante 45 minutos.

Propiedad	Valor
Parameter group:	TLS Auto Arguments

--tls-san-dns

Nombres alternativos del firmante DNS para el certificado. Use valores separados por espacios.

Propiedad	Valor
Parameter group:	TLS Auto Arguments

--tls-san-ip

Nombres alternativos del firmante de IP para el certificado. Use valores separados por espacios.

Propiedad	Valor
Parameter group:	TLS Auto Arguments

--tls-secret-name

Secreto para almacenar el certificado de servidor. Los datos existentes se sobrescribirán. Se trata de una referencia al secreto a través de un nombre de identificación, no el propio secreto.

Propiedad	Valor
Parameter group:	TLS Auto Arguments

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Output format.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az iot ops broker listener port remove

Quite una configuración de puerto tcp de un servicio de escucha de agente mqtt.

Si no existirá ningún puerto tcp después de quitar el comando, eliminará el recurso del agente de escucha.

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

Ejemplos

Quite la configuración del puerto tcp 1883 de un agente de escucha. El agente de escucha se eliminará si no permanece ningún puerto.

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

Parámetros requeridos

--instance -i

Nombre de instancia de IoT Operations.

--listener -n

Listener name.

--port

Puerto del servicio de escucha.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

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.

Propiedad	Valor
Valor predeterminado:	default

--yes -y

Confirme [y]es sin un mensaje. Útil para escenarios de CI y automatización.

Propiedad	Valor
Valores aceptados:	false, true

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Output format.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

Compartir a través de

az iot ops broker listener port

Comandos

az iot ops broker listener port add

Ejemplos

Parámetros requeridos

Parámetros opcionales

az iot ops broker listener port remove

Ejemplos

Parámetros requeridos

Parámetros opcionales

Comentarios