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à.

# S3
<a name="s3-rule-action"></a>

L’operazione S3 (`s3`) scrive i dati da un messaggio MQTT in un bucket Amazon Simple Storage Service (Amazon S3). 

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

Questa operazione della regola presenta i seguenti requisiti:
+ Un ruolo IAM che AWS IoT può assumere per eseguire l'operazione. `s3:PutObject` 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.
+ Se utilizzi un servizio AWS KMS gestito dal cliente AWS KMS key per crittografare i dati inattivi in Amazon S3, il servizio deve disporre dell'autorizzazione a utilizzarlo per AWS KMS key conto del chiamante. Per ulteriori informazioni, consulta [AWS Managed AWS KMS keys e Customer managed AWS KMS keys](https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingKMSEncryption.html#aws-managed-customer-managed-cmks) nella *Amazon Simple Storage Service Developer Guide*.

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

Quando crei una AWS IoT regola con questa azione, devi specificare le seguenti informazioni:

`bucket`  
Il bucket Amazon S3 in cui scrivere i dati.  
Supporta [modelli sostitutivi](iot-substitution-templates.md): solo API AWS CLI 

`cannedacl`  
(Facoltativo) Lista di controllo degli accessi predefinita Amazon S3 che controlla l'accesso all'oggetto identificato dalla chiave dell'oggetto. Per ulteriori informazioni, inclusi i valori consentiti, consulta la pagina relativa alle [liste di controllo degli accessi predefinite](https://docs.aws.amazon.com/AmazonS3/latest/userguide/acl-overview.html#canned-acl).   
Supporta [modelli di sostituzione](iot-substitution-templates.md): no

`key`  
Percorso del file in cui vengono scritti i dati.  
Considera un esempio in cui questo parametro è `${topic()}/${timestamp()}` e la regola riceve un messaggio in cui l'argomento è `some/topic`. Se il timestamp corrente è `1460685389`, questa operazione scrive i dati in un file chiamato `1460685389` nella cartella `some/topic` del bucket S3.  
Se utilizzi una chiave statica, AWS IoT sovrascrive un singolo file ogni volta che viene richiamata la regola. Consigliamo di utilizzare il timestamp di un messaggio o un altro identificatore univoco del messaggio in modo che, per ogni messaggio ricevuto, venga salvato un nuovo file in Amazon S3.
Supporta [modelli di sostituzione](iot-substitution-templates.md): sì

`roleArn`  
Il ruolo IAM che permette l'accesso al bucket Amazon S3. Per ulteriori informazioni, consulta [Requisiti](#s3-rule-action-requirements).  
Supporta [modelli di sostituzione](iot-substitution-templates.md): no

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

Il seguente esempio JSON definisce un'azione S3 in una regola. AWS IoT 

```
{
    "topicRulePayload": {
        "sql": "SELECT * FROM 'some/topic'", 
        "ruleDisabled": false, 
        "awsIotSqlVersion": "2016-03-23",
        "actions": [
            {
                "s3": {
                    "bucketName": "amzn-s3-demo-bucket", 
                    "cannedacl": "public-read",
                    "key": "${topic()}/${timestamp()}",
                    "roleArn": "arn:aws:iam::123456789012:role/aws_iot_s3"
                }
            }
        ]
    }
}
```

## Consulta anche
<a name="s3-rule-action-see-also"></a>
+ [Cos’è Amazon S3?](https://docs.aws.amazon.com/AmazonS3/latest/userguide/) nella *Guida per l'utente di Amazon Simple Storage Service*