SQS - AWS IoT Core
要件パラメータ例関連情報

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

SQS

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

注記

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

要件

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

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

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

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

パラメータ

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

queueUrl

データを書き込む Amazon SQSキューURLの 。このリージョンは、AWS IoT ルール AWS リージョン と同じであるURL必要はありません。

注記

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

関連情報