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à.
Firehose
L'azione Firehose (firehose) invia i dati da un messaggio MQTT a uno stream Amazon Data Firehose.
Requisiti
Questa operazione della regola presenta i seguenti requisiti:
-
Un ruolo IAM che AWS IoT può assumere l'esecuzione dell'operazione.
firehose:PutRecordPer ulteriori informazioni, consulta Concessione di un AWS IoT regola l'accesso che richiede.Nella AWS IoT console, puoi scegliere o creare un ruolo per consentire l'esecuzione AWS IoT di questa azione basata sulla regola.
-
Se utilizzi Firehose per inviare dati a un bucket Amazon S3 e utilizzi un AWS KMS cliente che è riuscito AWS KMS key a crittografare i dati inattivi in Amazon S3, Firehose deve avere accesso al bucket e il permesso di utilizzarli per conto del chiamante. AWS KMS key Per ulteriori informazioni, consulta Concedere a Firehose l'accesso a una destinazione Amazon S3 nella Amazon Data Firehose Developer Guide.
Parameters
Quando crei una AWS IoT regola con questa azione, devi specificare le seguenti informazioni:
batchMode-
(Facoltativo) Se fornire lo stream Firehose come batch utilizzando
PutRecordBatch. Il valore predefinito èfalse.Quando
batchModeètruee l'istruzione SQL della regola restituisce un array, ogni elemento dell'array forma un record nella richiestaPutRecordBatch. L'array risultante non può avere più di 500 record.Supporta modelli di sostituzione: no
deliveryStreamName-
Il flusso Firehose in cui scrivere i dati del messaggio.
Supporta modelli sostitutivi: API e solo AWS CLI
separator-
(Facoltativo) Un separatore di caratteri utilizzato per separare i record scritti nello stream Firehose. Se ometti questo parametro, il flusso non utilizza alcun separatore. Valori validi:
,(virgola),\t(scheda),\n(nuova riga),\r\n(Nuova riga di Windows).Supporta modelli di sostituzione: no
roleArn-
Il ruolo IAM che consente l'accesso allo stream Firehose. Per ulteriori informazioni, consulta Requisiti.
Supporta modelli di sostituzione: no
Esempi
Il seguente esempio JSON definisce un'azione Firehose in una regola. AWS IoT
{ "topicRulePayload": { "sql": "SELECT * FROM 'some/topic'", "ruleDisabled": false, "awsIotSqlVersion": "2016-03-23", "actions": [ { "firehose": { "deliveryStreamName": "my_firehose_stream", "roleArn": "arn:aws:iam::123456789012:role/aws_iot_firehose" } } ] } }
Il seguente esempio JSON definisce un'azione Firehose con modelli di sostituzione in una regola. AWS IoT
{ "topicRulePayload": { "sql": "SELECT * FROM 'some/topic'", "ruleDisabled": false, "awsIotSqlVersion": "2016-03-23", "actions": [ { "firehose": { "deliveryStreamName": "${topic()}", "roleArn": "arn:aws:iam::123456789012:role/aws_iot_firehose" } } ] } }
Consulta anche
-
Che cos'è Amazon Data Firehose? nella Amazon Data Firehose Developer Guide