Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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

L'action S3 (`s3`) écrit les données d'un message MQTT dans un compartiment Amazon Simple Storage Service (Amazon S3). 

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

Cette action réglementaire est assortie des exigences suivantes :
+ Rôle IAM qui AWS IoT peut assumer la réalisation de l'`s3:PutObject`opération. Pour de plus amples informations, veuillez consulter [Accorder à une AWS IoT règle l'accès dont elle a besoin](iot-create-role.md).

  Dans la AWS IoT console, vous pouvez choisir ou créer un rôle pour autoriser l'exécution AWS IoT de cette action de règle.
+ Si vous utilisez un service AWS KMS géré par le client AWS KMS key pour chiffrer des données au repos dans Amazon S3, le service doit être autorisé à l'utiliser au nom AWS KMS key de l'appelant. Pour plus d'informations, consultez les sections « [AWS géré » AWS KMS keys et « géré par le client](https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingKMSEncryption.html#aws-managed-customer-managed-cmks) » AWS KMS keys dans le manuel *Amazon Simple Storage Service Developer Guide*.

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

Lorsque vous créez une AWS IoT règle avec cette action, vous devez spécifier les informations suivantes :

`bucket`  
Compartiment Amazon S3 dans lequel écrire les données..  
Supporte les [modèles de substitution](iot-substitution-templates.md) : API et AWS CLI uniquement

`cannedacl`  
Liste ACL prédéfinie Amazon S3 qui contrôle l'accès à l'objet identifié par la clé d'objet. Pour plus d'informations, y compris les valeurs autorisées, voir [Canned ACL](https://docs.aws.amazon.com/AmazonS3/latest/userguide/acl-overview.html#canned-acl).   
Prend en charge les [modèles de substitution](iot-substitution-templates.md) :Non

`key`  
Chemin d'accès au fichier dans lequel les données sont écrites.  
Prenons un exemple où ce paramètre se trouve `${topic()}/${timestamp()}` et où la règle reçoit un message contenant le sujet `some/topic`. Si l'horodatage actuel est le cas`1460685389`, cette action écrit les données dans un fichier appelé `1460685389` dans le `some/topic` dossier du compartiment S3.  
Si vous utilisez une clé statique, elle AWS IoT remplace un seul fichier à chaque fois que la règle est invoquée. Nous vous recommandons d'utiliser l'horodatage du message ou un autre identifiant de message unique afin qu'un nouveau fichier soit enregistré dans Amazon S3 pour chaque message reçu.
Prend en charge les [modèles de substitution](iot-substitution-templates.md) : Oui

`roleArn`  
Rôle IAM qui autorise l'accès au compartiment Amazon S3. Pour de plus amples informations, veuillez consulter [Exigences](#s3-rule-action-requirements).  
Prend en charge les [modèles de substitution](iot-substitution-templates.md) : Non

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

L'exemple JSON suivant définit une action S3 dans une AWS IoT règle.

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

## Consultez aussi
<a name="s3-rule-action-see-also"></a>
+ [Qu’est-ce qu'Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/) dans le *Guide de l'utilisateur Amazon Simple Storage Service*.