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’operazione S3 (s3) scrive i dati da un messaggio MQTT in un bucket Amazon Simple Storage Service (Amazon S3).

Requisiti

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.

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

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

roleArn

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

Supporta modelli di sostituzione: no

Esempi

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

Consulta anche