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