AWS Command Line Interface (AWS CLI) を使用して、Amazon Simple Notification Service (Amazon SNS) の機能にアクセスできます。Amazon SNS 用の AWS CLI コマンドを一覧表示するには、次のコマンドを使用します。
aws sns help
コマンドを実行する前に、デフォルトの認証情報を設定します。詳細については、「AWS CLI の設定を構成する」を参照してください。
このトピックでは、Amazon SNS の一般的なタスクを実行する AWS CLI コマンドの例について説明します。
トピックの作成
トピックを作成するには、sns
create-topic
$
aws sns create-topic --name
my-topic
{ "TopicArn": "arn:aws:sns:us-west-2:123456789012:my-topic" }
レスポンスの TopicArn
を書き留めます。これは、後でメッセージを発行するために使用します。
トピックへのサブスクライブ
トピックをサブスクライブするには、sns
subscribe
次の例では、email
プロトコルと notification-endpoint
の E メールアドレスを指定します。
$
aws sns subscribe --topic-arn arn:aws:sns:us-west-2:123456789012:
my-topic
--protocolsaanvi@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.
トピックへの発行
トピックのすべての受信者にメッセージを送信するには、sns
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
に送信します。
トピックからサブスクリプションを解除する
トピックのサブスクリプションを解除し、そのトピックに発行されたメッセージの受信を停止するには、sns
unsubscribe
$
aws sns unsubscribe --subscription-arn
arn:aws:sns:us-west-2:123456789012:my-topic:1328f057-de93-4c15-512e-8bb22EXAMPLE
サブスクリプションが正常に解除されたことを確認するには、sns
list-subscriptions
$
aws sns list-subscriptions
トピックの削除
トピックを削除するには、sns
delete-topic
$
aws sns delete-topic --topic-arn arn:aws:sns:us-west-2:123456789012:my-topic
AWS によってトピックが正常に削除されたことを確認するには、sns
list-topics
$
aws sns list-topics