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). L'estensione installerà automaticamente la prima volta che si esegue un comando az iot ops broker listener port . Learn more about extensions.

Operazioni sulla porta del listener broker Mqtt.

Comandi

Nome	Descrizione	Tipo	Status
az iot ops broker listener port add	Aggiungere una configurazione della porta TCP a un servizio listener broker mqtt.	Extension	GA
az iot ops broker listener port remove	Rimuovere una configurazione della porta TCP da un servizio listener broker mqtt.	Extension	GA

az iot ops broker listener port add

Aggiungere una configurazione della porta TCP a un servizio listener broker mqtt.

Si tratta di un'operazione di aggiunta o sostituzione (porta). Se la risorsa del listener di destinazione non esiste, il comando lo creerà.

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]

Esempio

Aggiungere una configurazione della porta al listener IP del cluster predefinito, usando la porta 8883 e una risorsa di autenticazione.

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

Creare un nuovo listener con bilanciamento del carico del tipo di servizio usando una configurazione della porta che accetta connessioni TCP sulla porta 1883 senza autenticazione o autenticazione.

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

Aggiungere una configurazione della porta a un listener esistente usando le impostazioni di tls automatico di base sulla porta 8883 con autenticazione.

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

Parametri necessari

--instance -i

Nome dell'istanza di IoT Operations.

--listener -n

Listener name.

--port

Porta del servizio listener.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri facoltativi

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

--authn-ref

Riferimento all'autenticazione (nome).

Proprietà	Valore
Parameter group:	Auth Arguments

--authz-ref

Riferimento all'autorizzazione (nome).

Proprietà	Valore
Parameter group:	Auth Arguments

--broker -b

Broker name.

Proprietà	Valore
Valore predefinito:	default

--nodeport

Il servizio listener espone una porta statica sull'indirizzo IP di ogni nodo. Rilevante solo quando questa porta è associata a un listener NodePort.

Proprietà	Valore
Parameter group:	Node Port Arguments

--protocol

Protocollo da usare per le connessioni client.

Proprietà	Valore
Valori accettati:	Mqtt, WebSockets

--service-name

Nome del servizio Kubernetes del listener. Utilizzato quando non esiste un listener di destinazione.

--service-type

Tipo di servizio Kubernetes del listener. Utilizzato quando non esiste un listener di destinazione.

Proprietà	Valore
Valore predefinito:	LoadBalancer
Valori accettati:	ClusterIp, LoadBalancer, NodePort

--show-config

Mostra la configurazione della risorsa generata invece di richiamare l'API con essa.

Proprietà	Valore
Valori accettati:	false, true

--tls-duration

Durata del certificato. Deve essere specificato utilizzando un'ora. Formato durata (h|m|s). Ad esempio, 240 ore per 240 ore e 45 minuti per 45 minuti.

Proprietà	Valore
Parameter group:	TLS Auto Arguments

--tls-issuer-ref

Informazioni di riferimento sulle autorità di certificazione Cert-manager. Il formato è coppie chiave=valore separate da spazi. Sono supportate le chiavi seguenti: group, kind, name. kind e name sono obbligatori, mentre group ha un valore predefinito "cert-manager.io".

Proprietà	Valore
Parameter group:	TLS Auto Arguments

--tls-key-algo

Algoritmo per la chiave privata.

Proprietà	Valore
Parameter group:	TLS Auto Arguments
Valori accettati:	Ec256, Ec384, Ec521, Ed25519, Rsa2048, Rsa4096, Rsa8192

--tls-key-rotation

Criteri di rotazione delle chiavi private di Gestione certificati.

Proprietà	Valore
Parameter group:	TLS Auto Arguments
Valori accettati:	Always, Never

--tls-man-secret-ref

Segreto contenente un certificato client X.509. Si tratta di un riferimento al segreto tramite un nome di identificazione, non il segreto stesso.

Proprietà	Valore
Parameter group:	TLS Manual Arguments

--tls-renew-before

Quando iniziare a rinnovare il certificato. Deve essere specificato usando un'ora di go. Formato durata (h|m|s). Ad esempio, 240 ore per 240 ore e 45 minuti per 45 minuti.

Proprietà	Valore
Parameter group:	TLS Auto Arguments

--tls-san-dns

Nomi alternativi del soggetto DNS per il certificato. Usare valori separati da spazi.

Proprietà	Valore
Parameter group:	TLS Auto Arguments

--tls-san-ip

Nomi alternativi dell'oggetto IP per il certificato. Usare valori separati da spazi.

Proprietà	Valore
Parameter group:	TLS Auto Arguments

--tls-secret-name

Segreto per l'archiviazione del certificato del server. Tutti i dati esistenti verranno sovrascritti. Si tratta di un riferimento al segreto tramite un nome di identificazione, non il segreto stesso.

Proprietà	Valore
Parameter group:	TLS Auto Arguments

Parametri globali

--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Output format.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/ .

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per i log di debug completi.

Proprietà	Valore
Valore predefinito:	False

az iot ops broker listener port remove

Rimuovere una configurazione della porta TCP da un servizio listener broker mqtt.

Se non saranno presenti porte TCP dopo la rimozione, il comando eliminerà la risorsa listener.

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

Esempio

Rimuovere la configurazione della porta TCP 1883 da un listener. Il listener verrà eliminato se non rimangono porte.

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

Parametri necessari

--instance -i

Nome dell'istanza di IoT Operations.

--listener -n

Listener name.

--port

Porta del servizio listener.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri facoltativi

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.

Proprietà	Valore
Valore predefinito:	default

--yes -y

Confermare [y]es senza una richiesta. Utile per scenari di integrazione continua e automazione.

Proprietà	Valore
Valori accettati:	false, true

Parametri globali

--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Output format.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/ .

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per i log di debug completi.

Proprietà	Valore
Valore predefinito:	False

Condividi tramite

az iot ops broker listener port

Comandi

az iot ops broker listener port add

Esempio

Parametri necessari

Parametri facoltativi

az iot ops broker listener port remove

Esempio

Parametri necessari

Parametri facoltativi

Commenti e suggerimenti