AWS Command Line Interface
ユーザーガイド

Amazon SNS で AWS Command Line Interface を使用する

AWS CLI を使用して、Amazon Simple Notification Service (Amazon SNS) の機能にアクセスすることができます。Amazon SNS の AWS CLI コマンドをリストするには、次のコマンドを使用します。

aws sns help

コマンドを実行する前に、デフォルトの認証情報を設定します。詳細については、「AWS CLI の設定」を参照してください。

このトピックでは、Amazon SNS の一般的なタスクを実行する CLI コマンドの例を示します。

トピックの作成

トピックを作成するには、create-topic コマンドを使用し、トピックに割り当てる名前を指定します。

aws sns create-topic --name my-topic { "TopicArn": "arn:aws:sns:us-west-2:123456789012:my-topic" }

レスポンスの TopicArn を書き留めます。これは、後でメッセージを発行するために使用します。

トピックへのサブスクライブ

トピックをサブスクライブするには、subscribe コマンドを使用します。次の例では、email プロトコルと notification-endpoint の E メールアドレスを指定します。

aws sns subscribe --topic-arn arn:aws:sns:us-west-2:123456789012:my-topic --protocol email --notification-endpoint saanvi@example.com { "SubscriptionArn": "pending confirmation" }

AWS は、subscribe コマンドで指定したアドレスに E メールで確認メッセージを送信します。E メールメッセージには、次のようなテキストが含まれています。

You have chosen to subscribe to the topic: arn:aws:sns:us-west-2:123456789012:my-topic To confirm this subscription, click or visit the following link (If this was in error no action is necessary): Confirm subscription

受信者が サブスクリプションを確認 リンクをクリックすると、受信者のブラウザに次のような情報を含んだ通知メッセージが表示されます。

Subscription confirmed! You have subscribed saanvi@example.com to the topic:my-topic. Your subscription's id is: arn:aws:sns:us-west-2:123456789012:my-topic:1328f057-de93-4c15-512e-8bb22EXAMPLE If it was not your intention to subscribe, click here to unsubscribe.

トピックへの発行

トピックのすべての受信者にメッセージを送信するには、publish コマンドを使用します。次の例では、指定されたトピックのすべての受信者に「Hello World!」というメッセージを送信します。

aws sns publish --topic-arn arn:aws:sns:us-west-2:123456789012:my-topic --message "Hello World!" { "MessageId": "4e41661d-5eec-5ddf-8dab-2c867EXAMPLE" }

この例では、AWS は、「Hello World!」というテキストを含んだ E メールメッセージを saanvi@example.com に送信します。

トピックからサブスクリプションを解除する

トピックのサブスクライブを解除して、そのトピックに発行されるメッセージの受信を停止するには、unsubscribe コマンドを使用し、サブスクライブを解除するトピックの ARN を指定します。

aws sns unsubscribe --subscription-arn arn:aws:sns:us-west-2:123456789012:my-topic:1328f057-de93-4c15-512e-8bb22EXAMPLE

サブスクライブが正常に解除されたことを確認するには、list-subscriptions コマンドを使用して、ARN がリストに表示されなくなったことを確認します。

aws sns list-subscriptions

トピックの削除

トピックを削除するには、delete-topic コマンドを実行します。

$ aws sns delete-topic --topic-arn arn:aws:sns:us-west-2:123456789012:my-topic

AWS がトピックを正常に削除したことを確認するには、list-topics コマンドを使用して、トピックがリストに表示されなくなったことを確認します。

aws sns list-topics