기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# AWS IoT Events
<a name="iotevents-rule-action"></a>

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

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

## 요구 사항
<a name="iotevents-rule-action-requirements"></a>

이 규칙 작업은 다음 요구 사항을 충족해야 합니다.
+ `iotevents:BatchPutMessage` 작업을 수행하기 위해가 맡을 AWS IoT 수 있는 IAM 역할입니다. 자세한 내용은 [AWS IoT 규칙에 필요한 액세스 권한 부여](iot-create-role.md) 단원을 참조하십시오.

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

## 파라미터
<a name="iotevents-rule-action-parameters"></a>

이 작업을 사용하여 AWS IoT 규칙을 생성할 때 다음 정보를 지정해야 합니다.

`batchMode`  
(선택 사항) 이벤트 작업을 배치로 처리할지 여부입니다. 기본값은 `false`입니다.  
`batchMode`가 `true` 이고 규칙 SQL 문이 배열로 평가되면를 호출하여 AWS IoT 이벤트로 전송할 때 각 배열 요소가 별도의 메시지로 처리됩니다[https://docs.aws.amazon.com/iotevents/latest/apireference/API_iotevents-data_BatchPutMessage.html](https://docs.aws.amazon.com/iotevents/latest/apireference/API_iotevents-data_BatchPutMessage.html). 결과 배열의 메시지는 10개를 초과할 수 없습니다.  
`batchMode`가 `true`인 경우 `messageId`를 지정할 수 없습니다.  
[대체 템플릿](iot-substitution-templates.md) 지원: 아니요

`inputName`  
 AWS IoT Events 입력의 이름입니다.  
[대체 템플릿](iot-substitution-templates.md) 지원: API 및 AWS CLI 만 해당

`messageId`  
(선택 사항) 지정된가 있는 하나의 입력(메시지)만 AWS IoT Events 감지기에 의해 `messageId` 처리되는지 확인하려면이 옵션을 사용합니다. `${newuuid()}` 대체 템플릿을 사용하여 각 요청에 대해 고유한 ID를 생성할 수 있습니다.  
`batchMode`가 `true`인 경우 `messageId`을 지정할 수 없습니다--새 UUID 값이 할당됩니다.  
[대체 템플릿](iot-substitution-templates.md) 지원: 예

`roleArn`  
가 감지 AWS IoT 기에 입력을 전송하도록 허용하는 IAM 역할입니다 AWS IoT Events . 자세한 내용은 [요구 사항](#iotevents-rule-action-requirements) 단원을 참조하십시오.  
[대체 템플릿](iot-substitution-templates.md) 지원: 아니오

## 예제
<a name="iotevents-rule-action-examples"></a>

다음 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"
                }
            }
        ]
    }
}
```

## 다음 사항도 참조하세요.
<a name="iotevents-rule-action-see-also"></a>
+ *AWS IoT Events 개발자 안내서*의 [란 무엇입니까 AWS IoT Events?](https://docs.aws.amazon.com/iotevents/latest/developerguide/)