S3 - AWS IoT Core
PrérequisParamètresExemplesConsultez aussi

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

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

Prérequis

Cette action réglementaire est assortie des exigences suivantes :

  • Rôle IAM qui AWS IoT peut assumer la réalisation de l's3:PutObjectopération. Pour plus d’informations, consultez 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

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.

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 sujet some/topic. Si l'horodatage actuel est le cas1460685389, cette action écrit les données dans un fichier appelé 1460685389 dans le some/topic dossier 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

Rôle IAM qui autorise l'accès au compartiment Amazon S3. Pour plus d’informations, consultez Prérequis.

Prend en charge les modèles de substitution : Non

Exemples

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": "my-bucket", 
                    "cannedacl": "public-read",
                    "key": "${topic()}/${timestamp()}",
                    "roleArn": "arn:aws:iam::123456789012:role/aws_iot_s3"
                }
            }
        ]
    }
}

Consultez aussi