aws-sns: add page (#12259)

Co-authored-by: Juri Dispan <juri.dispan@posteo.net>

pages/common/aws-sns.md

@@ -0,0 +1,36 @@
+# aws sns
+
+> Create topics and subscriptions, send and receive messages, and monitor events and logs for the Amazon Simple Notification Service.
+> More information: <https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/index.html>.
+
+- List all objects of a specific type:
+
+`aws sns list-{{origination-numbers|phone-numbers-opted-out|platform-applications|sms-sandbox-phone-numbers|subscriptions|topics}}`
+
+- Create a topic with a specific name and show its Amazon Resource Name (ARN):
+
+`aws sns create-topic --name {{name}}`
+
+- Subscribe an email address to the topic with a specific ARN and show the subscription ARN:
+
+`aws sns subscribe --topic-arn {{topic_ARN}} --protocol email --notification-endpoint {{email}}`
+
+- Publish a message to a specific topic or phone number and show the message ID:
+
+`aws sns publish {{--topic-arn "arn:aws:sns:us-west-2:123456789012:topic-name"||--phone-number +1-555-555-0100}} --message file://{{path/to/file}}`
+
+- Delete the subscription with a specific ARN from its topic:
+
+`aws sns unsubscribe --subscription-arn {{subscription_ARN}}`
+
+- Create a platform endpoint:
+
+`aws sns create-platform-endpoint --platform-application-arn {{platform_application_ARN}} --token {{token}}`
+
+- Add a statement to a topic's access control policy:
+
+`aws sns add-permission --topic-arn {{topic_ARN}} --label {{topic_label}} --aws-account-id {{account_id}} --action-name {{AddPermission|CreatePlatformApplication|DeleteEndpoint|GetDataProtectionPolicy|GetEndpointAttributes|Subscribe|...}}`
+
+- Add a tag to the topic with a specific ARN:
+
+`aws sns tag-resource --resource-arn {{topic_ARN}} --tags {{Key=tag1_key Key=tag2_key,Value=tag2_value ...}}`