Awsclaw SNS

Awsclaw SNS

Manage SNS topics, subscriptions, publishing, platform applications, and SMS.

When to Use This Skill

Use this skill when the user:

• Asks about SNS topics or notifications
• Wants to publish messages to a topic
• Needs to inspect subscriptions or endpoints
• Asks about SMS, platform applications, or push notifications
• Wants to check data protection policies or sandbox status
• Wants to create or delete topics, subscriptions, or endpoints
• Needs to configure topic or subscription attributes

Tool: SNSTool

Execute AWS SNS commands. ALWAYS provide params object.

Commands

ListTopics

List all SNS topics.

{ "command": "ListTopics", "params": {} }

Parameters:

GetTopicAttributes

Get attributes of a topic (policy, subscriptions count, etc.).

{ "command": "GetTopicAttributes", "params": { "TopicArn": "arn:aws:sns:us-east-1:123456789012:my-topic" } }

Parameters:

Publish

Publish a message to a topic.

{ "command": "Publish", "params": { "TopicArn": "arn:aws:sns:...", "Message": "Hello World", "Subject": "Test" } }

Parameters:

ListSubscriptions

List all subscriptions across topics.

{ "command": "ListSubscriptions", "params": {} }

Parameters:

ListSubscriptionsByTopic

List subscriptions for a specific topic.

{ "command": "ListSubscriptionsByTopic", "params": { "TopicArn": "arn:aws:sns:..." } }

Parameters:

GetSubscriptionAttributes

Get attributes of a subscription.

{ "command": "GetSubscriptionAttributes", "params": { "SubscriptionArn": "arn:aws:sns:..." } }

Parameters:

ListTagsForResource

List tags for an SNS resource.

{ "command": "ListTagsForResource", "params": { "ResourceArn": "arn:aws:sns:..." } }

Parameters:

ListPlatformApplications

List push notification platform applications.

{ "command": "ListPlatformApplications", "params": {} }

Parameters:

GetPlatformApplicationAttributes

Get attributes of a platform application.

{ "command": "GetPlatformApplicationAttributes", "params": { "PlatformApplicationArn": "arn:aws:sns:..." } }

Parameters:

ListEndpointsByPlatformApplication

List endpoints for a platform application.

{ "command": "ListEndpointsByPlatformApplication", "params": { "PlatformApplicationArn": "arn:aws:sns:..." } }

Parameters:

GetEndpointAttributes

Get attributes of an endpoint.

{ "command": "GetEndpointAttributes", "params": { "EndpointArn": "arn:aws:sns:..." } }

Parameters:

GetSMSAttributes

Get SMS sending attributes.

{ "command": "GetSMSAttributes", "params": { "attributes": ["DefaultSMSType", "MonthlySpendLimit"] } }

Parameters:

GetSMSSandboxAccountStatus

Check if the account is in SMS sandbox.

{ "command": "GetSMSSandboxAccountStatus", "params": {} }

Parameters: None required.

GetDataProtectionPolicy

Get data protection policy for a topic.

{ "command": "GetDataProtectionPolicy", "params": { "ResourceArn": "arn:aws:sns:..." } }

Parameters:

CheckIfPhoneNumberIsOptedOut

Check if a phone number has opted out.

{ "command": "CheckIfPhoneNumberIsOptedOut", "params": { "phoneNumber": "+12345678901" } }

Parameters:

ListPhoneNumbersOptedOut

List phone numbers that have opted out.

{ "command": "ListPhoneNumbersOptedOut", "params": {} }

ListOriginationNumbers

List origination phone numbers.

{ "command": "ListOriginationNumbers", "params": {} }

Lifecycle Commands

CreateTopic

Create a new topic.

{ "command": "CreateTopic", "params": { "Name": "alerts" } }

Subscribe

Subscribe an endpoint to a topic.

{ "command": "Subscribe", "params": { "TopicArn": "arn:aws:sns:...:alerts", "Protocol": "email", "Endpoint": "[email protected]" } }

ConfirmSubscription

Confirm a subscription (for token-based subscriptions).

{ "command": "ConfirmSubscription", "params": { "TopicArn": "arn:aws:sns:...:alerts", "Token": "token" } }

Unsubscribe

Unsubscribe an endpoint.

{ "command": "Unsubscribe", "params": { "SubscriptionArn": "arn:aws:sns:..." } }

SetTopicAttributes

Update topic attributes.

{ "command": "SetTopicAttributes", "params": { "TopicArn": "arn:aws:sns:...:alerts", "AttributeName": "DisplayName", "AttributeValue": "Alerts" } }

SetSubscriptionAttributes

Update subscription attributes.

{ "command": "SetSubscriptionAttributes", "params": { "SubscriptionArn": "arn:aws:sns:...", "AttributeName": "RawMessageDelivery", "AttributeValue": "true" } }

CreatePlatformApplication

Create a platform application.

{ "command": "CreatePlatformApplication", "params": { "Name": "mobile-app", "Platform": "APNS", "Attributes": { "PlatformCredential": "..." } } }

CreatePlatformEndpoint

Create a platform endpoint.

{ "command": "CreatePlatformEndpoint", "params": { "PlatformApplicationArn": "arn:aws:sns:...", "Token": "device-token" } }

DeleteTopic

Delete a topic.

{ "command": "DeleteTopic", "params": { "TopicArn": "arn:aws:sns:...:alerts" } }

DeletePlatformApplication

Delete a platform application.

{ "command": "DeletePlatformApplication", "params": { "PlatformApplicationArn": "arn:aws:sns:..." } }

DeleteEndpoint

Delete a platform endpoint.

{ "command": "DeleteEndpoint", "params": { "EndpointArn": "arn:aws:sns:..." } }

TagResource

Tag an SNS resource.

{ "command": "TagResource", "params": { "ResourceArn": "arn:aws:sns:...", "Tags": [{ "Key": "env", "Value": "prod" }] } }

UntagResource

Remove tags from an SNS resource.

{ "command": "UntagResource", "params": { "ResourceArn": "arn:aws:sns:...", "TagKeys": ["env"] } }

---

Related Services

• SNS → SQS: SNS topics commonly subscribe to SQS queues for fan-out. Use ListSubscriptionsByTopic to find SQS subscriptions, then SQSTool to inspect queues
• SNS → Lambda: SNS can trigger Lambda functions. Use ListSubscriptionsByTopic to find Lambda subscriptions
• SNS → S3: S3 event notifications can publish to SNS. Use S3Tool GetBucketNotificationConfiguration to find the topic
• SNS → CloudWatch: SNS delivery metrics are in CloudWatch Metrics
• SNS → CloudFormation: SNS resources managed by CloudFormation stacks