Firehose

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

要件

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

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

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

• Firehose を使用して Amazon S3 バケットにデータを送信し、カスタマー管理の AWS KMS AWS KMS key を使用して Amazon S3 に保管中のデータを暗号化する場合、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 とは」