AWS IoT Events - AWS IoT Core
요구 사항파라미터예시다음 사항도 참조하세요.

AWS IoT Events

AWS IoT Events(iotEvents) 작업은 MQTT 메시지의 데이터를 AWS IoT Events 입력에 전송합니다.

중요

페이로드가 Input attribute Key 없이 AWS IoT Core로 전송되거나 키가 키에 지정된 것과 동일한 JSON 경로에 있지 않은 경우 Failed to send message to Iot Events 오류와 함께 IoT 규칙이 실패합니다.

요구 사항

이 규칙 작업은 다음 요구 사항을 충족해야 합니다.

  • AWS IoT가 iotevents:BatchPutMessage 작업을 수행하기 위해 수임할 수 있는 IAM 역할입니다. 자세한 내용은 액세스가 필요한 AWS IoT 규칙 권한 부여 단원을 참조하세요.

    AWS IoT 콘솔에서 역할을 선택하거나 생성하여 AWS IoT가 규칙 작업을 수행할 수 있도록 합니다.

파라미터

이 작업을 포함한 AWS IoT 규칙을 생성할 때 다음 정보를 지정해야 합니다.

batchMode

(선택 사항) 이벤트 작업을 배치로 처리할지 여부입니다. 기본값은 false입니다.

batchMode가 true이고 규칙 SQL 문이 Array로 평가되는 경우 각 Array 요소는 BatchPutMessage를 호출하여 AWS IoT Events로 전송될 때 개별 메시지로 전송됩니다. 결과 배열의 메시지는 10개를 초과할 수 없습니다.

batchMode가 true인 경우 messageId를 지정할 수 없습니다.

대체 템플릿 지원: 아니요

inputName

AWS IoT Events 입력의 이름입니다.

대체 템플릿 지원: API 및 AWS CLI만

messageId

(선택 사항) AWS IoT Events 감지기가 지정된 messageId를 가진 입력(메시지) 하나만 처리한다는 것을 확인할 때 사용합니다. ${newuuid()} 대체 템플릿을 사용하여 각 요청에 대해 고유한 ID를 생성할 수 있습니다.

batchMode가 true인 경우 messageId을 지정할 수 없습니다--새 UUID 값이 할당됩니다.

대체 템플릿 지원: 예

roleArn

AWS IoT가 입력을 AWS IoT Events 감지기로 전송하도록 허용하는 IAM 역할입니다. 자세한 내용은 요구 사항 단원을 참조하세요.

대체 템플릿 지원: 아니오

예시

다음 JSON 예제에서는 AWS IoT 규칙에서 IoT Events 작업을 정의합니다.

{
    "topicRulePayload": {
        "sql": "SELECT * FROM 'some/topic",
        "ruleDisabled": false,
        "awsIotSqlVersion": "2016-03-23",
        "actions": [
            {
                "iotEvents": {
                    "inputName": "MyIoTEventsInput",
                    "messageId": "${newuuid()}",
                    "roleArn": "arn:aws:iam::123456789012:role/aws_iot_events"
                }
            }
        ]
    }
}

다음 사항도 참조하세요.