Firehose

Firehose (firehose) アクションは、MQTT メッセージから Amazon Data Firehose ストリーミングにデータを送信します。

要件

このルールアクションには、以下の要件があります。

オペレーションを実行するためにが引き受けAWS IoTることができる IAM ロールfirehose:PutRecord。詳細については、「必要なアクセスをAWS IoTルールに付与する」を参照してください。

AWS IoTコンソールで、このルールアクションを実行することをに許可AWS IoTするロールを選択または作成できます。
Firehose を使用して Amazon S3 バケットにデータを送信し、カスタマーマネージド AWS KMS keyを使用してAWS KMS Amazon S3 に保管中のデータを暗号化する場合、Firehose はバケットへのアクセス権と、発信者に代わって AWS KMS keyを使用するアクセス許可を持っている必要があります。詳細については、「Amazon Firehose データファイアハウスデベロッパーガイド」の「Amazon S3 送信先に Firehose アクセスを付与する」を参照してください。

パラメータ

このアクションで AWS IoTルールを作成するときは、次の情報を指定する必要があります。

batchMode

(オプション) PutRecordBatch を使用して、Firehose ストリーミングをバッチとして配信するかどうか。デフォルト値は false です。

batchMode が true で、ルールの SQL ステートメントが配列に評価される場合、各配列要素は PutRecordBatch リクエストで 1 つのレコードを形成します。結果の配列には 500 を超えるレコードを含めることはできません。

置換テンプレートをサポート: いいえ

deliveryStreamName

メッセージデータの書き込み先として指定する Firehose ストリーム。

代替テンプレートをサポート: API および AWS CLIのみ

separator

(オプション) Firehose ストリーミングに書き込まれたレコードを区切るために使用される文字区切り記号。このパラメータを省略すると、ストリーミングは区切り記号を使用しません。有効な値: , (カンマ)、\t (タブ)、\n (改行)、\r\n (Windows 改行)。

置換テンプレートをサポート: いいえ

roleArn

Firehose ストリーミングへのアクセスを許可する IAM ロール。詳細については、「要件」を参照してください。

置換テンプレートをサポート: いいえ

例

次の JSON の例では、 AWS IoTルールで Firehose アクションを定義します。


{
    "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"
                }
            }
        ] 
    }
}

次の JSON の例では、 AWS IoTルールで置換テンプレートを使用して Firehose アクションを定義します。


{
    "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"
                }
            }
        ]
    }
}

Firehose

要件

パラメータ

例

関連情報