Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

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

L'azione AWS IoT Events (`iotEvents`) invia i dati da un messaggio MQTT a un AWS IoT Events input. 

**Importante**  
Se il payload viene inviato AWS IoT Core senza o se la chiave non si trova nello stesso percorso JSON specificato nella chiave, la regola IoT non funzionerà con l'errore. `Input attribute Key` `Failed to send message to Iot Events`

## Requisiti
<a name="iotevents-rule-action-requirements"></a>

Questa operazione della regola presenta i seguenti requisiti:
+ Un ruolo IAM che AWS IoT può assumere di eseguire l'`iotevents:BatchPutMessage`operazione. Per ulteriori informazioni, consulta [Concedere a qualsiasi AWS IoT regola l'accesso richiesto](iot-create-role.md).

  Nella AWS IoT console, puoi scegliere o creare un ruolo che consenta di AWS IoT eseguire questa azione relativa alla regola.

## Parameters
<a name="iotevents-rule-action-parameters"></a>

Quando si crea una AWS IoT regola con questa azione, è necessario specificare le seguenti informazioni:

`batchMode`  
(Facoltativo) Indica se elaborare le azioni evento come batch. Il valore predefinito è `false`.  
Quando l'istruzione SQL `batchMode` is `true` e la regola restituisce un Array, ogni elemento Array viene trattato come un messaggio separato quando viene inviato a AWS IoT Events tramite una chiamata [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). L'array risultante non può avere più di 10 messaggi.  
Quando `batchMode` è `true`, non è possibile specificare un `messageId`.   
Supporta [modelli di sostituzione](iot-substitution-templates.md): no

`inputName`  
Il nome dell' AWS IoT Events input.  
Supporta [modelli sostitutivi](iot-substitution-templates.md): solo API AWS CLI 

`messageId`  
(Facoltativo) Utilizzatelo per verificare che un solo input (messaggio) con un dato dato `messageId` venga elaborato da un AWS IoT Events rilevatore. Puoi utilizzare il modello di sostituzione `${newuuid()}` per generare un ID univoco per ogni richiesta.  
Quando `batchMode` è `true`, non è possibile specificare un valore `messageId`: verrà assegnato un nuovo valore UUID.  
Supporta [modelli di sostituzione](iot-substitution-templates.md): sì

`roleArn`  
Il ruolo IAM che consente di AWS IoT inviare un input a un AWS IoT Events rilevatore. Per ulteriori informazioni, consulta [Requisiti](#iotevents-rule-action-requirements).  
Supporta [modelli di sostituzione](iot-substitution-templates.md): no

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

L'esempio JSON seguente illustra come definire un'operazione Eventi IoT in una regola AWS IoT .

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

## Consulta anche
<a name="iotevents-rule-action-see-also"></a>
+ [Che cos'è AWS IoT Events?](https://docs.aws.amazon.com/iotevents/latest/developerguide/) nella *Guida per gli AWS IoT Events sviluppatori*