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.
L'action S3 (s3) écrit les données d'un MQTT message dans un compartiment Amazon Simple Storage Service (Amazon S3).
Prérequis
Cette action réglementaire est assortie des exigences suivantes :
-
IAMRôle qui AWS IoT peut assumer la réalisation de l'
s3:PutObjectopération. Pour de plus amples informations, veuillez consulter Accorder à une AWS IoT règle l'accès dont elle a besoin.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 » AWS KMS keys dans le manuel Amazon Simple Storage Service Developer Guide.
Paramètres
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 : API et AWS CLI uniquement
cannedacl-
(Facultatif) Le scan Amazon S3 ACL qui contrôle l'accès à l'objet identifié par la clé de l'objet. Pour plus d'informations, notamment sur les valeurs autorisées, consultez la section Canned ACL.
Prend en charge les modèles de substitution :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 sujetsome/topic. Si l'horodatage actuel est le cas1460685389, cette action écrit les données dans un fichier appelé1460685389dans lesome/topicdossier du compartiment S3.Note
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 : Oui
roleArn-
IAMRôle qui autorise l'accès au compartiment Amazon S3. Pour de plus amples informations, veuillez consulter Prérequis.
Prend en charge les modèles de substitution : Non
Exemples
L'JSONexemple 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
-
Qu’est-ce qu'Amazon S3 dans le Guide de l'utilisateur Amazon Simple Storage Service.
