Step Functions を使用して Amazon SNSトピックにメッセージを発行する - AWS Step Functions

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

Step Functions を使用して Amazon SNSトピックにメッセージを発行する

Step Functions を使用して Amazon SNSトピックにメッセージを発行する方法について説明します。このページには、サポートされている Amazon SNSAPIアクションが一覧表示され、Amazon にメッセージを発行するためのTask状態例が表示されますSNS。

との統合について学ぶには AWS Step Functions の サービスについては、 サービスとの統合「」および「」を参照してくださいStep Functions APIのサービスへのパラメータの受け渡し

最適化された Amazon SNS統合の主な機能

レスポンスのリクエスト または タスクトークンによるコールバックを待つ 統合パターンの最適化はありません。

以下には、Amazon Simple Notification Service (Amazon Task SNS) トピックに発行する状態が含まれます。

{ "StartAt": "Publish to SNS", "States": { "Publish to SNS": { "Type": "Task", "Resource": "arn:aws:states:::sns:publish", "Parameters": { "TopicArn": "arn:aws:sns:us-east-1:123456789012:myTopic", "Message.$": "$.input.message", "MessageAttributes": { "my_attribute_no_1": { "DataType": "String", "StringValue": "value of my_attribute_no_1" }, "my_attribute_no_2": { "DataType": "String", "StringValue": "value of my_attribute_no_2" } } }, "End": true } } }

動的な値を渡す。上記の例を変更して、このJSONペイロードから属性を動的に渡すことができます。

{ "input": { "message": "Hello world" }, "SNSDetails": { "attribute1": "some value", "attribute2": "some other value", } }

.$StringValue フィールドに追加:

"MessageAttributes": { "my_attribute_no_1": { "DataType": "String", "StringValue.$": "$.SNSDetails.attribute1" }, "my_attribute_no_2": { "DataType": "String", "StringValue.$": "$.SNSDetails.attribute2" }

以下には、 が Amazon SNSトピックに発行し、タスクトークンが返されるまで待機するTask状態が含まれています。「タスクトークンによるコールバックを待つ」を参照してください。

{ "StartAt":"Send message to SNS", "States":{ "Send message to SNS":{ "Type":"Task", "Resource":"arn:aws:states:::sns:publish.waitForTaskToken", "Parameters":{ "TopicArn":"arn:aws:sns:us-east-1:123456789012:myTopic", "Message":{ "Input.$":"$", "TaskToken.$":"$$.Task.Token" } }, "End":true } } }

サポートされている Amazon SNS APIs

のパラメータ Step Functions は で表されます。 PascalCase

アクション camelCaseなどのネイティブサービスAPIが にある場合でもstartSyncExecution、 には API PascalCaseなどのパラメータを指定しますStateMachineArn

注記

Step Functions のタスクには入力データまたは結果データの最大サイズにはクォータがあります。これにより、別のサービスとの間でデータを送受信するときに、UTF-8 でエンコードされた文字列として 256 KB のデータに制限されます。「ステートマシンの実行に関連するクォータ」を参照してください。

IAM Amazon を呼び出すための ポリシー SNS

次のサンプルテンプレートは、 AWS Step Functions は、ステートマシン定義のリソースに基づいてIAMポリシーを生成します。詳細については、「Step Functions が統合サービスのIAMポリシーを生成する方法」および「Step Functions でサービス統合パターンを検出する」を参照してください。

静的リソース

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "sns:Publish" ], "Resource": [ "arn:aws:sns:[[region]]:[[accountId]]:[[topicName]]" ] } ] }

パスに基づくリソース、または TargetArnPhoneNumber に発行する

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "sns:Publish" ], "Resource": "*" } ] }