Firehose

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

要件

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

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

  AWS IoT コンソールで、 AWS IoT このルールアクションを実行するためのロールを選択または作成できます。

• Firehose を使用して Amazon S3 バケットにデータを送信し、カスタマーマネージドを使用して AWS KMS Amazon S3 に保存中のデータを AWS KMS key 暗号化する場合、Firehose はバケットへのアクセス権と、発信者に代わって AWS KMS key を使用するアクセス許可を持っている必要があります。詳細については、Amazon S3 送信先へのアクセス権を Firehose に付与する」を参照してください。

パラメータ

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

batchMode

（オプション) を使用して Firehose ストリームをバッチとして配信するかどうかPutRecordBatch。デフォルト値は 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"
                }
            }
        ]
    }
}

以下も参照してください。

• Amazon Data Firehose デベロッパーガイドの Amazon Data Firehose とは