SQS

SQS (sqs) アクションは、Amazon Simple Queue Service (Amazon SQS) キューに MQTT メッセージのデータを送信します。

注記

SQS アクションは、Amazon SQS FIFO (First-In-First-Out) キューをサポートしていません。ルールエンジンは完全に分散されたサービスであるため、SQS アクションがトリガーされたときのメッセージ順序の保証はありません。

要件

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

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

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

• AWS KMS カスタマー管理の を使用して Amazon AWS KMS key SQS に保管中のデータを暗号化する場合、サービスには AWS KMS key 発信者に代わって を使用するアクセス許可が必要です。 Amazon SQS 詳細については、Amazon Simple Storage Service デベロッパーガイドのキー管理を参照してください。

パラメータ

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

queueUrl

データの書き込み先として指定する Amazon SQS キューの URL。この URL のリージョンは、AWS IoT ルール AWS リージョン と同じである必要はありません。

注記

SQS ルールアクション AWS リージョン を使用したデータ転送クロスには追加料金が発生する場合があります。詳細については、「Amazon SQSの料金」を参照してください。

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

useBase64

このパラメータを true に設定して、データを Amazon SQS キューに書き込む前にメッセージデータを base64 エンコードするルールアクションを設定します。デフォルトは false です。

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

roleArn

Amazon SQS キューへのアクセスを許可する IAM ロール。詳細については、「要件」を参照してください。

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

例

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

{
    "topicRulePayload": {
        "sql": "SELECT * FROM 'some/topic'", 
        "ruleDisabled": false, 
        "awsIotSqlVersion": "2016-03-23",
        "actions": [
            {
                "sqs": {
                    "queueUrl": "https://sqs.us-east-2.amazonaws.com/123456789012/my_sqs_queue", 
                    "roleArn": "arn:aws:iam::123456789012:role/aws_iot_sqs"
                }
            }
        ]
    }
}

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

{
    "topicRulePayload": {
        "sql": "SELECT * FROM 'some/topic'",
        "ruleDisabled": false,
        "awsIotSqlVersion": "2016-03-23",
        "actions": [
            {
                "sqs": {
                    "queueUrl": "https://sqs.us-east-2.amazonaws.com/123456789012/${topic()}",
                    "useBase64": true,
                    "roleArn": "arn:aws:iam::123456789012:role/aws_iot_sqs"
                }
            }
        ]
    }
}

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

• Amazon Simple Queue Service デベロッパーガイドの Amazon Simple Queue Service とは