az iot device c2d-message
참고
이 참조는 Azure CLI 대한 azure-iot 확장의 일부이며 버전 2.17.1 이상이 필요합니다. az iot device c2d-message 명령을 처음 실행할 때 확장이 자동으로 설치됩니다. 확장에 대해 자세히 알아보세요.
클라우드-디바이스 메시징 명령.
명령
| az iot device c2d-message abandon |
클라우드-디바이스 메시지를 중단합니다. |
| az iot device c2d-message complete |
클라우드-디바이스 메시지를 완료합니다. |
| az iot device c2d-message purge |
대상 디바이스에 대한 클라우드-디바이스 메시지 큐를 제거합니다. |
| az iot device c2d-message receive |
클라우드-디바이스 메시지를 받습니다. |
| az iot device c2d-message reject |
클라우드-디바이스 메시지를 거부하거나 전달하지 않습니다. |
| az iot device c2d-message send |
클라우드-디바이스 메시지를 보냅니다. |
az iot device c2d-message abandon
클라우드-디바이스 메시지를 중단합니다.
az iot device c2d-message abandon --device-id
--etag
[--hub-name]
[--login]
[--resource-group]
필수 매개 변수
대상 디바이스.
리소스의 마지막 상태에 해당하는 Etag 또는 엔터티 태그입니다. etag가 제공되지 않으면 ' * ' 값이 사용됩니다.
선택적 매개 변수
IoT Hub 이름입니다.
이 명령은 작업을 수행할 수 있는 권한이 있는 엔터티 연결 문자열을 지원합니다. "az login"을 통해 세션 로그인을 방지하려면 를 사용합니다. 엔터티 연결 문자열과 이름이 둘 다 제공되면 연결 문자열이 우선합니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az iot device c2d-message complete
클라우드-디바이스 메시지를 완료합니다.
az iot device c2d-message complete --device-id
--etag
[--hub-name]
[--login]
[--resource-group]
필수 매개 변수
대상 디바이스.
리소스의 마지막 상태에 해당하는 Etag 또는 엔터티 태그입니다. etag가 제공되지 않으면 ' * ' 값이 사용됩니다.
선택적 매개 변수
IoT Hub 이름입니다.
이 명령은 작업을 수행할 수 있는 권한이 있는 엔터티 연결 문자열을 지원합니다. "az login"을 통해 세션 로그인을 방지하려면 를 사용합니다. 엔터티 연결 문자열과 이름이 둘 다 제공되면 연결 문자열이 우선합니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az iot device c2d-message purge
대상 디바이스에 대한 클라우드-디바이스 메시지 큐를 제거합니다.
az iot device c2d-message purge --device-id
[--hub-name]
[--login]
[--resource-group]
필수 매개 변수
대상 디바이스.
선택적 매개 변수
IoT Hub 이름입니다.
이 명령은 작업을 수행할 수 있는 권한이 있는 엔터티 연결 문자열을 지원합니다. "az login"을 통해 세션 로그인을 방지하려면 를 사용합니다. 엔터티 연결 문자열과 이름이 둘 다 제공되면 연결 문자열이 우선합니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az iot device c2d-message receive
클라우드-디바이스 메시지를 받습니다.
참고: 메시지 ack 인수 [--complete, --reject, --abandon]만 허용됩니다.
az iot device c2d-message receive --device-id
[--abandon {false, true}]
[--complete {false, true}]
[--hub-name]
[--lock-timeout]
[--login]
[--reject {false, true}]
[--resource-group]
예제
기본적인 사용 방법
az iot device c2d-message receive -d {device_id} -n {hub_name} -g {resource_group}
메시지를 수신하고 해당 메시지에 대한 잠금 시간 제한(30초)을 설정합니다.
az iot device c2d-message receive -d {device_id} -n {hub_name} -g {resource_group} --lt {30}
메시지를 수신하고 받은 후 '완료'로 ack합니다.
az iot device c2d-message receive -d {device_id} -n {hub_name} -g {resource_group} --complete
메시지를 받고 받은 후 거부합니다.
az iot device c2d-message receive -d {device_id} -n {hub_name} -g {resource_group} --reject
필수 매개 변수
대상 디바이스.
선택적 매개 변수
수신 후 클라우드-디바이스 메시지를 중단합니다.
수신 후 클라우드-디바이스 메시지를 완료합니다.
IoT Hub 이름입니다.
메시지가 다른 수신 호출에 표시되지 않을 시간을 지정합니다.
이 명령은 작업을 수행할 수 있는 권한이 있는 엔터티 연결 문자열을 지원합니다. "az login"을 통해 세션 로그인을 방지하려면 를 사용합니다. 엔터티 연결 문자열과 이름이 둘 다 제공되면 연결 문자열이 우선합니다.
수신 후 클라우드-디바이스 메시지를 거부합니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az iot device c2d-message reject
클라우드-디바이스 메시지를 거부하거나 전달하지 않습니다.
az iot device c2d-message reject --device-id
--etag
[--hub-name]
[--login]
[--resource-group]
필수 매개 변수
대상 디바이스.
리소스의 마지막 상태에 해당하는 Etag 또는 엔터티 태그입니다. etag가 제공되지 않으면 ' * ' 값이 사용됩니다.
선택적 매개 변수
IoT Hub 이름입니다.
이 명령은 작업을 수행할 수 있는 권한이 있는 엔터티 연결 문자열을 지원합니다. "az login"을 통해 세션 로그인을 방지하려면 를 사용합니다. 엔터티 연결 문자열과 이름이 둘 다 제공되면 연결 문자열이 우선합니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az iot device c2d-message send
클라우드-디바이스 메시지를 보냅니다.
EXPERIMENTAL에는 Python 3.4+가 필요합니다. 이 명령은 를 사용하며 처음 실행 시 종속 Cython 패키지(uamqp)를 설치할 수 있습니다. https://github.com/Azure/azure-uamqp-python.
az iot device c2d-message send --device-id
[--ack {full, negative, positive}]
[--auth-type {key, login}]
[--ce]
[--cid]
[--content-type]
[--da]
[--expiry]
[--hub-name]
[--login]
[--message-id]
[--properties]
[--repair {false, true}]
[--resource-group]
[--uid]
[--wait {false, true}]
[--yes {false, true}]
예제
기본 메시지 본문을 사용하는 기본 사용
az iot device c2d-message send -d {device_id} -n {iothub_name}
사용자 지정 데이터 및 속성을 사용하여 클라우드-디바이스 메시지를 보냅니다.
az iot device c2d-message send -d {device_id} -n {iothub_name} --data 'Hello World' --props 'key0=value0;key1=value1'
C2D 메시지 보내기 및 디바이스 승인 대기
az iot device c2d-message send -d {device_id} -n {iothub_name} --ack full --wait
필수 매개 변수
대상 디바이스.
선택적 매개 변수
해당 메시지의 최종 상태에 대한 메시지별 피드백 배달을 요청합니다. ack 값에 대한 설명은 다음과 같습니다. 긍정: c2d 메시지가 완료된 상태에 도달하면 IoT Hub 피드백 메시지를 생성합니다. 부정: c2d 메시지가 Dead lettered 상태에 도달하면 IoT Hub 피드백 메시지를 생성합니다. 전체: IoT Hub 두 경우 모두 피드백 메시지를 생성합니다. 기본적으로 Ack는 요청되지 않습니다.
작업에서 정책 키를 자동으로 파생할지 또는 현재 Azure AD 세션을 사용해야 하는지를 나타냅니다. 를 사용하여 기본값을 구성할 수 az configure --defaults iothub-data-auth-type=<auth-type-value> 있습니다.
C2D 메시지 본문에 대한 인코딩입니다.
C2D 메시지와 연결된 상관 관계 ID입니다.
C2D 메시지 본문의 콘텐츠 형식입니다.
메시지 본문입니다.
단위는 unix epoch 이후 밀리초입니다. 시간이 표시되지 않으면 기본 IoT Hub C2D 메시지 TTL이 사용됩니다.
IoT Hub 이름입니다.
이 명령은 작업을 수행할 수 있는 권한이 있는 엔터티 연결 문자열을 지원합니다. "az login"을 통해 세션 로그인을 방지하려면 를 사용합니다. 엔터티 연결 문자열과 이름이 둘 다 제공되면 연결 문자열이 우선합니다.
C2D 메시지 ID입니다. 메시지 ID가 제공되지 않으면 UUID가 생성됩니다.
a=b;c=d 형식의 키-값 쌍의 메시지 속성 백입니다.
확장 버전과 호환되는 uamqp 종속성을 다시 설치합니다. 기본값: false입니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
C2D 메시지, 사용자 ID 속성입니다.
설정된 경우 c2d 보내기 작업은 디바이스 피드백이 수신될 때까지 차단됩니다.
사용자 프롬프트를 건너뜁니다. 종속성 설치에 대한 동의를 나타냅니다(필요한 경우). 주로 자동화 시나리오에 사용됩니다. 기본값: false입니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.