다음을 통해 공유

az iot ops broker listener port

Note

이 참조는 Azure CLI azure-iot-ops 확장의 일부입니다(버전 2.70.0 이상). az iot ops broker 수신기 포트 명령을 처음 실행할 때 확장이 자동으로 설치됩니다. 확장 프로그램에 대해 자세히 알아보세요.

Mqtt broker 수신기 포트 작업

명령

Name Description 형식 상태
az iot ops broker listener port add

mqtt broker 수신기 서비스에 tcp 포트 구성을 추가합니다.

 Extension GA
az iot ops broker listener port remove

mqtt broker 수신기 서비스에서 tcp 포트 구성을 제거합니다.

 Extension GA

az iot ops broker listener port add

mqtt broker 수신기 서비스에 tcp 포트 구성을 추가합니다.

이는 추가 또는 바꾸기(포트) 작업입니다. 대상 수신기 리소스가 없으면 명령이 만듭니다.

az iot ops broker listener port add --instance
                                    --listener
                                    --port
                                    --resource-group
                                    [--acquire-policy-token]
                                    [--authn-ref]
                                    [--authz-ref]
                                    [--broker]
                                    [--change-reference]
                                    [--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]

예제

포트 8883 및 authn 리소스를 사용하여 기본 클러스터 Ip 수신기에 포트 구성을 추가합니다.

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

authz 또는 authn 없이 포트 1883에서 tcp 연결을 허용하는 포트 구성을 사용하여 서비스 유형 부하 분산 장치를 사용하여 새 수신기를 만듭니다.

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

authn과 함께 포트 8883에서 기본 자동 tls 설정을 사용하여 기존 수신기에 포트 구성을 추가합니다.

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

IoT Operations 인스턴스 이름입니다.

--listener -n

수신기 이름입니다.

--port

수신기 서비스 포트입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--acquire-policy-token

이 리소스 작업에 대한 Azure Policy 토큰을 자동으로 획득합니다.

속성 값
매개 변수 그룹: Global Policy Arguments
--authn-ref

인증 참조(이름).

속성 값
매개 변수 그룹: Auth Arguments
--authz-ref

권한 부여 참조(이름).

속성 값
매개 변수 그룹: Auth Arguments
--broker -b

Broker 이름입니다.

속성 값
Default value: default
--change-reference

이 리소스 작업에 대한 관련 변경 참조 ID입니다.

속성 값
매개 변수 그룹: Global Policy Arguments
--nodeport

수신기 서비스는 각 노드의 IP 주소에 정적 포트를 노출합니다. 이 포트가 NodePort 수신기와 연결된 경우에만 관련됩니다.

속성 값
매개 변수 그룹: 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). 예를 들어 240시간은 240시간, 45분은 45m입니다.

속성 값
매개 변수 그룹: TLS Auto Arguments
--tls-issuer-ref

Cert-manager 발급자 참조입니다. 형식은 공백으로 구분된 키=값 쌍입니다. 지원group되는 키는 다음과 kindname같습니다. kind 기본 name 값은 'cert-manager.io'인 반면 group 에 필수입니다.

속성 값
매개 변수 그룹: TLS Auto Arguments
--tls-key-algo

프라이빗 키에 대한 알고리즘입니다.

속성 값
매개 변수 그룹: TLS Auto Arguments
허용되는 값: Ec256, Ec384, Ec521, Ed25519, Rsa2048, Rsa4096, Rsa8192
--tls-key-rotation

Cert-manager 프라이빗 키 회전 정책입니다.

속성 값
매개 변수 그룹: TLS Auto Arguments
허용되는 값: Always, Never
--tls-man-secret-ref

X.509 클라이언트 인증서를 포함하는 비밀입니다. 이는 비밀 자체가 아니라 식별 이름을 통해 비밀에 대한 참조입니다.

속성 값
매개 변수 그룹: TLS Manual Arguments
--tls-renew-before

인증서 갱신을 시작하는 경우 Go 시간을 사용하여 지정해야 합니다. 기간 형식(h|m|s). 예를 들어 240시간은 240시간, 45분은 45m입니다.

속성 값
매개 변수 그룹: TLS Auto Arguments
--tls-san-dns

인증서의 DNS 주체 대체 이름입니다. 공백으로 구분된 값을 사용합니다.

속성 값
매개 변수 그룹: TLS Auto Arguments
--tls-san-ip

인증서의 IP 주체 대체 이름입니다. 공백으로 구분된 값을 사용합니다.

속성 값
매개 변수 그룹: TLS Auto Arguments
--tls-secret-name

서버 인증서를 저장하기 위한 비밀입니다. 기존 데이터는 덮어씁니다. 이는 비밀 자체가 아니라 식별 이름을 통해 비밀에 대한 참조입니다.

속성 값
매개 변수 그룹: TLS Auto 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

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성 값
Default value: False

az iot ops broker listener port remove

mqtt broker 수신기 서비스에서 tcp 포트 구성을 제거합니다.

제거 후 tcp 포트가 없으면 명령은 수신기 리소스를 삭제합니다.

az iot ops broker listener port remove --instance
                                       --listener
                                       --port
                                       --resource-group
                                       [--acquire-policy-token]
                                       [--broker]
                                       [--change-reference]
                                       [--yes {false, true}]

예제

수신기에서 tcp 포트 1883 구성을 제거합니다. 포트가 남아 있지 않으면 수신기가 삭제됩니다.

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

필수 매개 변수

--instance -i

IoT Operations 인스턴스 이름입니다.

--listener -n

수신기 이름입니다.

--port

수신기 서비스 포트입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--acquire-policy-token

이 리소스 작업에 대한 Azure Policy 토큰을 자동으로 획득합니다.

속성 값
매개 변수 그룹: Global Policy Arguments
--broker -b

Broker 이름입니다.

속성 값
Default value: default
--change-reference

이 리소스 작업에 대한 관련 변경 참조 ID입니다.

속성 값
매개 변수 그룹: 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

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성 값
Default value: False