기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
예약된 주제
달러 기호 ($) 로 시작하는 주제는 에서 사용하도록 예약되어 AWS IoT있습니다. 예약된 주제는 허용된 대로 구독하고 게시할 수 있지만 달러 기호로 시작하는 새 주제는 생성할 수 없습니다. 예약된 주제에 대해 지원되지 않는 게시 또는 구독 작업으로 인해 연결이 종료될 수 있습니다.
자산 모델 주제
주제 | 허용된 클라이언트 작업 | 설명 |
---|---|---|
|
Subscribe |
AWS IoT SiteWise 이 주제에 대한 자산 자산 알림을 게시합니다. 자세한 내용은 AWS IoT SiteWise 사용 설명서의 다른 AWS 서비스와의 상호 작용을 참조하십시오. |
AWS IoT Device Defender 주제
이러한 메시지는 주제의 페이로드 형식에 따라 간결한 이진 객체 표현 (CBOR) 형식 및 JavaScript 객체 표기법 (JSON) 의 응답 버퍼를 지원합니다.
AWS IoT Device Defender 주제는 MQTT 게시만 지원합니다.
payload-format |
응답 형식 데이터 유형 |
---|---|
cbor | Concise Binary Object Representation(CBOR) |
json | JavaScript 객체 표기법 (JSON) |
자세한 내용은 디바이스에서 메트릭 전송을 참조하십시오.
주제 | 허용된 작업 | 설명 |
---|---|---|
$aws/things/ |
게시 |
AWS IoT Device Defender 상담원은 이 주제에 메트릭을 게시합니다. 자세한 내용은 장치에서 메트릭 전송을 참조하십시오. |
$aws/things/ |
Subscribe |
AWS IoT AWS IoT Device Defender |
$aws/things/ |
Subscribe |
AWS IoT AWS IoT Device Defender |
AWS IoT Core 장치 위치 주제
AWS IoT Core 장치 위치는 장치의 측정 데이터를 확인하고 IoT 장치의 예상 위치를 제공할 수 있습니다. 장치의 측정 데이터에는 GNSS, Wi-Fi, 셀룰러 및 IP 주소가 포함될 수 있습니다. AWS IoT Core 그런 다음 장치 위치는 최상의 정확도를 제공하는 측정 유형을 선택하고 장치 위치 정보를 해석합니다. 자세한 내용은 AWS IoT Core 디바이스 위치 및 AWS IoT Core 디바이스 위치 MQTT 주제를 사용하여 디바이스 위치 해석 섹션을 참조하세요.
주제 | 허용된 작업 | 설명 |
---|---|---|
$aws/device_location/ |
게시 |
장치는 이 주제에 게시하여 스캔한 원시 측정 데이터를 장치 위치에서 확인할 수 있도록 합니다. AWS IoT Core |
$aws/device_location/ |
Subscribe |
AWS IoT Core 장치 위치가 성공적으로 확인되면 장치 위치가 이 항목에 게시됩니다. |
$aws/device_location/ |
Subscribe |
AWS IoT Core 4xx 오류로 인해 장치 위치를 제대로 확인할 수 없는 경우 장치 위치가 이 항목에 게시됩니다. |
이벤트 주제
주제 | 허용된 클라이언트 작업 | 설명 |
---|---|---|
$aws/이벤트/인증서/등록/ |
Subscribe |
AWS IoT 인증서를 AWS IoT 자동으로 등록하고 클라이언트가 상태가 포함된 인증서를 제시할 때 이 메시지를 게시합니다. |
$aws/events/job/ |
Subscribe |
AWS IoT 작업이 취소되면 이 메시지를 게시합니다. 자세한 정보는 작업 이벤트을 참조하세요. |
$aws/events/job/jobID /cancellation_in_progress |
Subscribe |
AWS IoT 작업 취소가 진행 중일 때 이 메시지를 게시합니다. 자세한 정보는 작업 이벤트을 참조하세요. |
$aws/events/job/ |
Subscribe |
AWS IoT 작업이 완료되면 이 메시지를 게시합니다. 자세한 정보는 작업 이벤트을 참조하세요. |
$aws/events/job/jobID /deleted |
Subscribe |
AWS IoT 작업이 삭제될 때 이 메시지를 게시합니다. 자세한 정보는 작업 이벤트을 참조하세요. |
$aws/events/job/jobID /deletion_in_progress |
Subscribe |
AWS IoT 작업 삭제가 진행 중일 때 이 메시지를 게시합니다. 자세한 정보는 작업 이벤트을 참조하세요. |
$aws/events/jobExecution/jobID /canceled |
Subscribe |
AWS IoT 작업 실행이 취소될 때 이 메시지를 게시합니다. 자세한 정보는 작업 이벤트을 참조하세요. |
$aws/events/jobExecution/jobID /deleted |
Subscribe |
AWS IoT 작업 실행이 삭제될 때 이 메시지를 게시합니다. 자세한 정보는 작업 이벤트을 참조하세요. |
$aws/events/jobExecution/jobID /failed |
Subscribe |
AWS IoT 작업 실행이 실패했을 때 이 메시지를 게시합니다. 자세한 정보는 작업 이벤트을 참조하세요. |
$aws/events/jobExecution/jobID /rejected |
Subscribe |
AWS IoT 작업 실행이 거부된 경우 이 메시지를 게시합니다. 자세한 정보는 작업 이벤트을 참조하세요. |
$aws/events/jobExecution/jobID /removed |
Subscribe |
AWS IoT 작업 실행이 제거되면 이 메시지를 게시합니다. 자세한 정보는 작업 이벤트을 참조하세요. |
$aws/events/jobExecution/jobID /succeeded |
Subscribe |
AWS IoT 작업 실행이 성공하면 이 메시지를 게시합니다. 자세한 정보는 작업 이벤트을 참조하세요. |
$aws/events/jobExecution/jobID /timed_out |
Subscribe |
AWS IoT 작업 실행 시간이 초과되면 이 메시지를 게시합니다. 자세한 정보는 작업 이벤트을 참조하세요. |
$aws/events/presence/connected/ |
Subscribe |
AWS IoT 지정된 클라이언트 ID를 가진 MQTT 클라이언트가 연결되면 이 주제에 게시됩니다. AWS IoT자세한 정보는 연결/연결 해제 이벤트을 참조하세요. |
$aws/events/presence/disconnected/ |
Subscribe |
AWS IoT 지정된 클라이언트 ID를 가진 MQTT 클라이언트의 연결이 끊어지면 이 주제에 게시됩니다. AWS IoT자세한 정보는 연결/연결 해제 이벤트을 참조하세요. |
$aws/events/subscriptions/subscribed/ |
Subscribe |
AWS IoT 지정된 클라이언트 ID를 가진 MQTT 클라이언트가 MQTT 주제를 구독하면 이 주제에 게시됩니다. 자세한 정보는 구독/구독 취소 이벤트을 참조하세요. |
$aws/events/subscriptions/unsubscribed/ |
Subscribe |
AWS IoT 지정된 클라이언트 ID를 가진 MQTT 클라이언트가 MQTT 주제 구독을 취소하면 이 주제에 게시됩니다. 자세한 정보는 구독/구독 취소 이벤트을 참조하세요. |
$aws/events/thing/ |
Subscribe |
AWS IoT |
$aws/events/thing/ |
Subscribe |
AWS IoT |
$aws/events/thing/ |
Subscribe |
AWS IoT |
|
Subscribe |
AWS IoT 사물 그룹이 생성되면 이 주제에 게시합니다. |
|
Subscribe |
AWS IoT 사물 그룹이 업데이트되면 이 주제에 게시합니다. |
|
Subscribe |
AWS IoT 사물 그룹이 삭제되면 이 주제에 게시합니다. |
|
Subscribe |
AWS IoT 사물 유형이 생성되면 이 주제에 게시됩니다. |
|
Subscribe |
AWS IoT 사물 유형이 업데이트되면 이 주제에 게시됩니다. |
|
Subscribe |
AWS IoT 사물 유형이 삭제되면 이 주제에 게시됩니다. |
|
Subscribe |
AWS IoT |
|
Subscribe |
AWS IoT |
|
Subscribe |
AWS IoT 사물 그룹에서 |
|
Subscribe |
AWS IoT |
|
Subscribe |
AWS IoT |
플릿 프로비저닝 주제
참고
이 표에서 Receive로 표시된 클라이언트 작업은 클라이언트가 주제를 구독했는지 여부에 관계없이 요청한 클라이언트에 직접 AWS IoT 게시하는 주제를 나타냅니다. 클라이언트는 이러한 응답 메시지를 구독하지 않은 경우에도 이들을 수신해야 합니다. 이러한 응답 메시지는 메시지 브로커를 통과하지 않으며 다른 클라이언트나 규칙에 의해 구독될 수 없습니다.
이러한 메시지는 주제의 페이로드 형식에 따라 간결한 이진 객체 표현 (CBOR) 형식 및 JSON ( JavaScript 객체 표기법) 의 응답 버퍼를 지원합니다.
payload-format |
응답 형식 데이터 유형 |
---|---|
cbor | Concise Binary Object Representation(CBOR) |
json | JavaScript 객체 표기법 (JSON) |
자세한 정보는 디바이스 프로비저닝 MQTT API을 참조하세요.
주제 | 허용된 클라이언트 작업 | 설명 |
---|---|---|
$aws/certificates/create/ |
게시 |
인증서 서명 요청(CSR)에서 인증서를 생성하려면 이 주제에 게시합니다. |
$aws/certificates/create/ |
구독, 수신 |
AWS IoT |
$aws/certificates/create/ |
구독, 수신 |
AWS IoT $aws/certificates/create/ |
|
게시 |
CSR에서 인증서를 생성하려면 이 주제에 게시합니다. |
|
구독, 수신 |
AWS IoT |
|
구독, 수신 |
AWS IoT |
$aws/provisioning-templates/ |
게시 |
사물을 등록하려면 이 주제에 게시합니다. |
$aws/provisioning-templates/ |
구독, 수신 |
AWS IoT |
$aws/provisioning-templates/ |
구독, 수신 |
AWS IoT |
작업 주제
참고
이 표에서 Receive로 표시된 클라이언트 작업은 클라이언트가 해당 주제를 구독했는지 여부에 관계없이 요청한 클라이언트에 직접 게시되는 AWS IoT 주제를 나타냅니다. 클라이언트는 이러한 응답 메시지를 구독하지 않은 경우에도 이들을 수신해야 합니다.
이러한 응답 메시지는 메시지 브로커를 통과하지 않으며 다른 클라이언트나 규칙에 의해 구독될 수 없습니다. 작업 활동 관련 메시지를 구독하려면 notify
및 notify-next
주제를 사용합니다.
플릿 모니터링 솔루션에 대한 작업 및 jobExecution
이벤트 주제를 구독할 때 먼저 작업 및 작업 실행 이벤트를 사용하여 클라우드 측에서 이벤트를 수신해야 합니다.
자세한 정보는 작업 디바이스 MQTT API 작업을 참조하세요.
주제 | 허용된 클라이언트 작업 | 설명 |
---|---|---|
$aws/things/ |
게시 |
디바이스에서 이 주제에 메시지를 게시해 |
$aws/things/ |
구독, 수신 |
디바이스에서 이 주제를 구독해 성공적인 |
$aws/things/ |
구독, 수신 |
|
$aws/things/ |
게시 |
디바이스에서 이 주제에 메시지를 게시해 |
$aws/things/ |
구독, 수신 |
디바이스에서 이 주제를 구독해 성공적인 |
$aws/things/ |
구독, 수신 |
|
$aws/things/ |
게시 |
디바이스에서 이 주제에 메시지를 게시해 |
$aws/things/ |
구독, 수신 |
디바이스에서 이 주제를 구독해 성공적인 |
$aws/things/ |
구독, 수신 |
|
$aws/things/ |
게시 |
디바이스에서 이 주제에 메시지를 게시해 |
$aws/things/ |
구독, 수신 |
디바이스에서 이 주제를 구독해 성공적인 참고$aws/things/ |
$aws/things/ |
구독, 수신 |
참고$aws/things/ |
$aws/things/ |
구독, 수신 |
디바이스에서 이 주제를 구독해 작업 실행이 사물에 대해 대기 중인 실행의 목록에서 추가되거나 제거될 때 알림을 받습니다. 자세한 내용은 작업 디바이스 MQTT API 작업 단원을 참조하세요. |
$aws/things/ |
구독, 수신 |
디바이스에서 이 주제를 구독해 사물에 대해 대기 중인 다음 작업 실행이 변경될 때 알림을 받습니다. 자세한 내용은 작업 디바이스 MQTT API 작업 단원을 참조하세요. |
$aws/events/job/ |
Subscribe |
작업 완료 시 작업 서비스가 이 주제에 대해 이벤트를 게시합니다. 자세한 내용은 작업 이벤트 단원을 참조하세요. |
$aws/events/job/ |
Subscribe |
작업 취소 시 작업 서비스가 이 주제에 대해 이벤트를 게시합니다. 자세한 내용은 작업 이벤트 단원을 참조하세요. |
$aws/events/job/ |
Subscribe |
작업 삭제 시 작업 서비스가 이 주제에 대해 이벤트를 게시합니다. 자세한 내용은 작업 이벤트 단원을 참조하세요. |
$aws/events/job/ |
Subscribe |
작업 취소 시작 시 작업 서비스가 이 주제에 대해 이벤트를 게시합니다. 자세한 내용은 작업 이벤트 단원을 참조하세요. |
$aws/events/job/ |
Subscribe |
작업 삭제 시작 시 작업 서비스가 이 주제에 대해 이벤트를 게시합니다. 자세한 내용은 작업 이벤트 단원을 참조하세요. |
$aws/events/jobExecution/ |
Subscribe |
작업 실행 성공 시 작업 서비스가 이 주제에 대해 이벤트를 게시합니다. 자세한 내용은 작업 이벤트 단원을 참조하세요. |
$aws/events/jobExecution/ |
Subscribe |
작업 실행 실패 시 작업 서비스가 이 주제에 대해 이벤트를 게시합니다. 자세한 내용은 작업 이벤트 단원을 참조하세요. |
$aws/events/jobExecution/ |
Subscribe |
작업 실행 거부 시 작업 서비스가 이 주제에 대해 이벤트를 게시합니다. 자세한 내용은 작업 이벤트 단원을 참조하세요. |
$aws/events/jobExecution/ |
Subscribe |
작업 실행 취소 시 작업 서비스가 이 주제에 대해 이벤트를 게시합니다. 자세한 내용은 작업 이벤트 단원을 참조하세요. |
$aws/events/jobExecution/ |
Subscribe |
작업 실행 시간 초과 시 작업 서비스가 이 주제에 대해 이벤트를 게시합니다. 자세한 내용은 작업 이벤트 단원을 참조하세요. |
$aws/events/jobExecution/ |
Subscribe |
작업 실행 제거 시 작업 서비스가 이 주제에 대해 이벤트를 게시합니다. 자세한 내용은 작업 이벤트 단원을 참조하세요. |
$aws/events/jobExecution/ |
Subscribe |
작업 실행 삭제 시 작업 서비스가 이 주제에 대해 이벤트를 게시합니다. 자세한 내용은 작업 이벤트 단원을 참조하세요. |
규칙 주제
주제 | 허용된 클라이언트 작업 | 설명 |
---|---|---|
$aws/rules/ |
게시 |
규칙을 직접 트리거하기 위해 디바이스 또는 애플리케이션이 이 주제에 게시합니다. 자세한 내용은 Basic Ingest를 통한 메시징 비용 절감 단원을 참조하세요. |
보안 터널링 주제
주제 | 허용된 클라이언트 작업 | 설명 |
---|---|---|
$aws/things/ |
Subscribe |
AWS IoT IoT 에이전트가 원격 장치에서 로컬 프록시를 시작할 수 있도록 이 메시지를 게시합니다. 자세한 정보는 IoT 에이전트 코드 조각을 참조하세요. |
섀도우 주제
이 섹션의 주제는 명명된 섀도우와 명명되지 않은 섀도우에서 사용됩니다. 각 섀도우에 사용되는 주제는 주제 접두사만 다릅니다. 이 표에서는 각 섀도우 유형에서 사용하는 주제 접두사를 보여줍니다.
ShadowTopicPrefix 값 |
섀도우 유형 |
---|---|
$aws/things/thingName /shadow |
명명되지 않은(클래식) 섀도우 |
$aws/things/thingName /shadow/name/shadowName |
명명된 섀도우 |
전체 주제를 생성하려면 참조하려는 섀도우 유형에 ShadowTopicPrefix
맞는 항목을 선택하고 ThingName
및 해당하는 경우 ShadownName을 해당 값으로 바꾼 다음 다음 표와 같이 주제 스텁에
추가합니다. 주제는 대/소문자를 구분합니다.
주제 | 허용된 클라이언트 작업 | 설명 |
---|---|---|
|
게시/구독 |
섀도우를 삭제하기 위해 디바이스 또는 애플리케이션이 이 주제에 게시합니다. 자세한 내용은 /delete 단원을 참조하세요. |
|
Subscribe |
섀도우가 삭제되면 디바이스 섀도우 서비스가 이 주제로 메시지를 전송합니다. 자세한 내용은 /delete/accepted/ 단원을 참조하세요. |
|
Subscribe |
섀도우 삭제 요청이 거부되면 디바이스 섀도우 서비스가 이 주제로 메시지를 전송합니다. 자세한 내용은 /delete/rejected 단원을 참조하세요. |
|
게시/구독 |
섀도우를 가져오기 위해 애플리케이션 또는 사물이 이 주제에 빈 메시지를 게시합니다. 자세한 정보는 디바이스 섀도우 MQTT 주제을 참조하세요. |
|
Subscribe |
섀도우에 대한 요청이 성공적으로 이루어지면 디바이스 섀도우 서비스가 이 주제로 메시지를 전송합니다. 자세한 내용은 /get/accepted 단원을 참조하세요. |
|
Subscribe |
섀도우 요청이 거부되면 디바이스 섀도우 서비스가 이 주제로 메시지를 전송합니다. 자세한 내용은 /get/rejected 단원을 참조하세요. |
|
게시/구독 |
섀도우를 업데이트하기 위해 사물 또는 애플리케이션이 이 주제에 게시합니다. 자세한 내용은 /update 단원을 참조하세요. |
|
Subscribe |
섀도우가 성공적으로 업데이트되면 디바이스 섀도우 서비스가 이 주제로 메시지를 전송합니다. 자세한 내용은 /update/accepted 단원을 참조하세요. |
|
Subscribe |
섀도우 업데이트가 거부되면 디바이스 섀도우 서비스가 이 주제로 메시지를 전송합니다. 자세한 내용은 /update/rejected 단원을 참조하세요. |
|
Subscribe |
섀도우의 reported 섹션과 desired 섹션 간의 차이가 감지되면 디바이스 섀도우 서비스가 이 주제로 메시지를 전송합니다. 자세한 내용은 /update/delta 단원을 참조하세요. |
|
Subscribe |
AWS IoT 섀도우 업데이트가 성공적으로 수행될 때마다 이 항목에 상태 문서를 게시합니다. 자세한 내용은 /update/documents 단원을 참조하세요. |
MQTT 기반 파일 전송 주제
참고
이 표에서 Receive로 표시된 클라이언트 작업은 클라이언트가 해당 주제를 구독했는지 여부에 관계없이 요청을 한 클라이언트에 직접 AWS IoT 게시하는 항목을 나타냅니다. 클라이언트는 이러한 응답 메시지를 구독하지 않은 경우에도 이들을 수신해야 합니다. 이러한 응답 메시지는 메시지 브로커를 통과하지 않으며 다른 클라이언트나 규칙에 의해 구독될 수 없습니다.
이러한 메시지는 주제의 페이로드 형식에 따라 간결한 이진 객체 표현 (CBOR) 형식 및 JSON ( JavaScript 객체 표기법) 의 응답 버퍼를 지원합니다.
payload-format |
응답 형식 데이터 유형 |
---|---|
cbor | Concise Binary Object Representation(CBOR) |
json | JavaScript 객체 표기법 (JSON) |
주제 | 허용된 클라이언트 작업 | 설명 |
---|---|---|
|
구독, 수신 |
AWS 디바이스의 "" 요청이 수락되면 MQTT 기반 파일 전송이 이 주제에 게시됩니다. GetStream 페이로드는 스트림 데이터를 포함합니다. 자세한 정보는 디바이스에서 AWS IoT MQTT 기반 파일 전송 사용을 참조하세요. |
|
게시 |
기기는 이 주제에 게시하여 "" 요청을 수행합니다. GetStream 자세한 정보는 디바이스에서 AWS IoT MQTT 기반 파일 전송 사용을 참조하세요. |
|
구독, 수신 |
AWS 디바이스의 "" 요청이 수락되면 MQTT 기반 파일 전송이 이 주제에 게시됩니다. DescribeStream 페이로드는 스트림 설명을 포함합니다. 자세한 정보는 디바이스에서 AWS IoT MQTT 기반 파일 전송 사용을 참조하세요. |
|
게시 |
기기는 이 주제에 게시하여 "" 요청을 수행합니다. DescribeStream 자세한 정보는 디바이스에서 AWS IoT MQTT 기반 파일 전송 사용을 참조하세요. |
|
구독, 수신 |
AWS MQTT 기반 파일 전송은 디바이스의 “" 또는 "" "요청이 거부되는 경우 이 주제에 게시됩니다. DescribeStream GetStream 자세한 정보는 디바이스에서 AWS IoT MQTT 기반 파일 전송 사용을 참조하세요. |
예약된 주제 ARN
모든 예약된 주제 Amazon 리소스 이름(ARN)의 형식은 다음과 같습니다.
arn:aws:iot:
aws-region
:AWS-account-ID
:topic/Topic
예, arn:aws:iot:us-west-2:123EXAMPLE456:topic/$aws/things/thingName/jobs/get/accepted
은(는) 예약된 주제 $aws/things/thingName/jobs/get/accepted
에 대한 ARN입니다.