S3 - AWS IoT Core
RequisitiParametriEsempiConsulta anche

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

L'azione S3 (s3) scrive i dati da un MQTT messaggio in un bucket Amazon Simple Storage Service (Amazon S3).

Requisiti

Questa operazione della regola presenta i seguenti requisiti:

  • Un IAM ruolo che AWS IoT può assumere per eseguire l'operazione. s3:PutObject Per ulteriori informazioni, consulta Concedere a qualsiasi AWS IoT regola l'accesso richiesto.

    Nella AWS IoT console, è possibile scegliere o creare un ruolo per consentire l'esecuzione di questa azione relativa AWS IoT 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 nella Amazon Simple Storage Service Developer Guide.

Parametri

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: API e solo AWS CLI

cannedacl

(Facoltativo) Amazon S3 canned ACL che controlla l'accesso all'oggetto identificato dalla chiave dell'oggetto. Per ulteriori informazioni, inclusi i valori consentiti, consulta Canned. ACL

Supporta modelli di sostituzione: 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.

Nota

Se usi 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: sì

roleArn

Il IAM ruolo che consente l'accesso al bucket Amazon S3. Per ulteriori informazioni, consulta Requisiti.

Supporta modelli di sostituzione: no

Esempi

L'JSONesempio seguente 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