AWS SNS

Manage SNS topics and publish notifications.

List topics

aws sns list-topics --query 'Topics[].TopicArn' --output table

Get topic attributes

aws sns get-topic-attributes --topic-arn "$SNS_TOPIC_ARN" | jq '.Attributes | {DisplayName, SubscriptionsConfirmed, SubscriptionsPending}'

List subscriptions

aws sns list-subscriptions-by-topic --topic-arn "$SNS_TOPIC_ARN" --query 'Subscriptions[].{Endpoint:Endpoint,Protocol:Protocol,Status:SubscriptionArn}' --output table

Publish message

aws sns publish --topic-arn "$SNS_TOPIC_ARN" \
  --subject "Alert" \
  --message "Deployment complete for v1.2.3" | jq '{MessageId}'

Publish JSON message (protocol-specific)

aws sns publish --topic-arn "$SNS_TOPIC_ARN" \
  --message-structure json \
  --message '{"default":"Alert","email":"Email body","sms":"SMS text"}' | jq '{MessageId}'

Subscribe endpoint

aws sns subscribe --topic-arn "$SNS_TOPIC_ARN" \
  --protocol email --notification-endpoint user@example.com | jq '{SubscriptionArn}'

Notes

• Email subscriptions require confirmation by the recipient.
• Confirm before publishing or subscribing endpoints.