AWS SNSアクション

このページでは、ワークフロー自動化アクションカタログで利用可能なAWS SNSアクションのリファレンスを提供します。これらのアクションを使用して、Amazon SNSトピックにメッセージを発行してください。

前提条件

前提条件と認証情報のセットアップについては、AWS認証情報のセットアップをご覧ください。

SNSトピックにメッセージを公開する

アクション識別子はaws.sns.publishです。

Amazon SNS トピックにメッセージを送信します。トピックのすべてのサブスクライバーがメッセージを受信します。

次の表に、このアクションの入力フィールドについて説明します。

入力	タイプ	説明	例
`awsRoleArn`	弦	オプション。 AWS APIコール用に引き受けるIAMロールARN。	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	弦	オプション。 AWSアクセスキーID。シークレットとして渡します。	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	弦	オプション。 AWSシークレットアクセスキー。シークレットとして渡します。	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	弦	オプション。 STS認証用の一時的なセッショントークンです。シークレットとして渡してください。	`${{ :secrets:awsSessionToken }}`
`region`	弦	必須。ターゲットSNSトピックのAWSリージョン。	`us-east-2`
`message`	弦	必須。パブリッシュするメッセージ。メッセージはUTF-8エンコードされた文字列で、サイズは最大256 KBである必要があります。 `PhoneNumber` は個人を特定できる情報（PII）であるため、このアクションから意図的に除外されています。直接SMSを送信するには、AWS SDKを直接使用してください。	`"Workflow failed at step 3"`
`topicArn`	弦	オプション。パブリッシュ先のトピックARN。 `topicArn` または `targetArn` のいずれかを指定する必要があります。	`arn:aws:sns:us-east-2:123456789012:my-topic`
`targetArn`	弦	オプション。パブリッシュ先のターゲットARN。 `topicArn` または `targetArn` のいずれかを指定する必要があります。	`arn:aws:sns:us-east-2:123456789012:MySNSTopic`
`subject`	弦	オプション。 Eメールベースのサブスクリプションの件名。	`"Workflow Update"`
`MessageStructure`	弦	オプション。異なるプロトコルに異なるメッセージを送信するには、 `json` に設定します。	`"json"`
`messageAttributes`	地図	オプション。メッセージに添付するメッセージ属性。	`{"string": {"DataType": "string", "StringValue": "string"}}`
`messageDeduplicationId`	弦	オプション。 FIFOトピックでのメッセージの重複排除に使用されるトークン。	`"abc123deduplicationId5678"`
`messageGroupId`	弦	オプション。 FIFOトピックのメッセージグループを指定するタグ。	`"order-processing-group-2023_A"`

次の表は、このアクションの出力フィールドについて説明しています。

出力	タイプ	例
`response`	オブジェクト	`{"MessageId": "2333ededwedwed-52f5-a716-e10355e3e2ff"}` 。 publish boto3 リファレンスを参照してください。
`success`	ブール値	`true \| false`
`errorMessage`	弦	`"An error occurred (InvalidParameter) when calling the Publish operation: Invalid parameter: TopicArn or TargetArn Reason: no value for required parameter"`

出力

タイプ

例

response

オブジェクト

{"MessageId": "2333ededwedwed-52f5-a716-e10355e3e2ff"}

。

publish boto3 リファレンス

を参照してください。

success

ブール値

true | false

errorMessage

弦

"An error occurred (InvalidParameter) when calling the Publish operation: Invalid parameter: TopicArn or TargetArn Reason: no value for required parameter"

name: sns-publish-test
description: Publishes a notification to an SNS topic
workflowInputs:
  arnRole:
    type: String
steps:
  - name: aws_sns_publish_1
    type: action
    action: aws.sns.publish
    version: '1'
    inputs:
      awsRoleArn: ${{ .workflowInputs.arnRole }}
      region: us-east-1
      topicArn: arn:aws:sns:us-east-1:123456789012:workflow-test-topic
      subject: "Workflow Update"
      message: "The data processing workflow has completed successfully."
    next: end

この機械翻訳は、参考として提供されています。

前提条件.css-21sua1{background:none;border:none;width:0;padding:0;}

SNSトピックにメッセージを公開する

前提条件