Dela via

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). Tillägget installeras automatiskt första gången du kör portkommandot az iot ops broker listener . Learn more about extensions.

Mqtt broker listener port operations( Mqtt broker listener port operations).

Kommandon

Name Description Typ Status
az iot ops broker listener port add

Lägg till en tcp-portkonfiguration till en lyssnartjänst för mqtt-koordinator.

 Extension GA
az iot ops broker listener port remove

Ta bort en tcp-portkonfiguration från en lyssnartjänst för mqtt-koordinator.

 Extension GA

az iot ops broker listener port add

Lägg till en tcp-portkonfiguration till en lyssnartjänst för mqtt-koordinator.

Det här är en åtgärd för att lägga till eller ersätta (port). Om mållyssningsresursen inte finns skapar kommandot den.

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]

Exempel

Lägg till en portkonfiguration i ip-lyssnaren för standardklustret med hjälp av port 8883 och en autentiseringsresurs.

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

Skapa en ny lyssnare med lastbalanserare av tjänsttyp med hjälp av en portkonfiguration som accepterar tcp-anslutningar på port 1883 utan authz eller autentisering.

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

Lägg till en portkonfiguration i en befintlig lyssnare med grundläggande inställningar för automatiska tls på port 8883 med 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

Obligatoriska parametrar

--instance -i

IoT Operations-instansens namn.

--listener -n

Listener name.

--port

Lyssnartjänstens port.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

Valfria parametrar

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

--authn-ref

Autentiseringsreferens (namn).

Egenskap Värde
Parameter group: Auth Arguments
--authz-ref

Auktoriseringsreferens (namn).

Egenskap Värde
Parameter group: Auth Arguments
--broker -b

Broker name.

Egenskap Värde
Standardvärde: default
--nodeport

Lyssnartjänsten exponerar en statisk port på varje nods IP-adress. Endast relevant när den här porten är associerad med en NodePort-lyssnare.

Egenskap Värde
Parameter group: Node Port Arguments
--protocol

Protokoll som ska användas för klientanslutningar.

Egenskap Värde
Godkända värden: Mqtt, WebSockets
--service-name

Kubernetes-tjänstens namn på lyssnaren. Används när en mållyssnare inte finns.

--service-type

Kubernetes-tjänsttypen för lyssnaren. Används när en mållyssnare inte finns.

Egenskap Värde
Standardvärde: LoadBalancer
Godkända värden: ClusterIp, LoadBalancer, NodePort
--show-config

Visa den genererade resurskonfigurationen i stället för att anropa API:et med den.

Egenskap Värde
Godkända värden: false, true
--tls-duration

Certifikatets livslängd. Måste anges med en tid. Varaktighetsformat (h|m|s). T.ex. 240h i 240 timmar och 45m i 45 minuter.

Egenskap Värde
Parameter group: TLS Auto Arguments
--tls-issuer-ref

Utfärdarreferens för Cert-manager. Formatet är blankstegsavgränsade nyckel=värdepar. Följande nycklar stöds: group, kind, name. kind och name krävs, medan group har standardvärdet "cert-manager.io".

Egenskap Värde
Parameter group: TLS Auto Arguments
--tls-key-algo

Algoritm för privat nyckel.

Egenskap Värde
Parameter group: TLS Auto Arguments
Godkända värden: Ec256, Ec384, Ec521, Ed25519, Rsa2048, Rsa4096, Rsa8192
--tls-key-rotation

Roteringsprincip för cert-manager för privat nyckel.

Egenskap Värde
Parameter group: TLS Auto Arguments
Godkända värden: Always, Never
--tls-man-secret-ref

Hemlighet som innehåller ett X.509-klientcertifikat. Det här är en referens till hemligheten via ett identifierande namn, inte själva hemligheten.

Egenskap Värde
Parameter group: TLS Manual Arguments
--tls-renew-before

När du ska börja förnya certifikatet. Måste anges med en Go-tid. Varaktighetsformat (h|m|s). T.ex. 240h i 240 timmar och 45m i 45 minuter.

Egenskap Värde
Parameter group: TLS Auto Arguments
--tls-san-dns

Alternativa DNS-ämnesnamn för certifikatet. Använd blankstegsavgränsade värden.

Egenskap Värde
Parameter group: TLS Auto Arguments
--tls-san-ip

Alternativa IP-ämnesnamn för certifikatet. Använd blankstegsavgränsade värden.

Egenskap Värde
Parameter group: TLS Auto Arguments
--tls-secret-name

Hemlighet för lagring av servercertifikat. Alla befintliga data skrivs över. Det här är en referens till hemligheten via ett identifierande namn, inte själva hemligheten.

Egenskap Värde
Parameter group: TLS Auto Arguments
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap Värde
Standardvärde: False
--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap Värde
Standardvärde: False
--output -o

Output format.

Egenskap Värde
Standardvärde: json
Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap Värde
Standardvärde: False

az iot ops broker listener port remove

Ta bort en tcp-portkonfiguration från en lyssnartjänst för mqtt-koordinator.

Om det inte finns några tcp-portar efter borttagningen tas lyssnarresursen bort.

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

Exempel

Ta bort tcp-port 1883-konfigurationen från en lyssnare. Lyssnaren tas bort om inga portar finns kvar.

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

Obligatoriska parametrar

--instance -i

IoT Operations-instansens namn.

--listener -n

Listener name.

--port

Lyssnartjänstens port.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

Valfria parametrar

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.

Egenskap Värde
Standardvärde: default
--yes -y

Bekräfta [y]es utan att fråga. Användbart för CI- och automationsscenarier.

Egenskap Värde
Godkända värden: false, true
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap Värde
Standardvärde: False
--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap Värde
Standardvärde: False
--output -o

Output format.

Egenskap Värde
Standardvärde: json
Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap Värde
Standardvärde: False