AddPermission Method

Adds permissions to the topic's access control policy.

Syntax

sns.addPermission(topicArn, policyLabel, AWSAccountIds, actionNames, [callback])

Callback

The 'callback' parameter specifies a function which will be called when the operation completes (or an error is encountered). If the 'callback' parameter is not specified, then the method will block and will not return until the operation completes (or an error is encountered).

The callback for this method is defined as:

function(err){ }

'err' is the error that occurred. If there was no error, then 'err' is 'null'.

'err' has 2 properties which hold detailed information:

err.code
err.message

Remarks

This method may be used to add a statement to the topic's access control policy.

TopicArn specifies the topic.

PolicyLabel should be set to a unique identifier for the new policy statement.

AWSAccountIds is a comma separated list of AWS account IDs of users who will be granted access to the specified actions. The users must have an AWS account, but do not need to be signed up for the SNS service.

ActionNames is a comma separated list of actions that corresponds to the AWS account IDs specified in AWSAccountIds. Possible values are:

AddPermission
CreateTopic
DeleteTopic
GetSubscriptionAttributes
GetTopicAttributes
ListSubscriptions
ListSubscriptionsByTopic
ListTopics
Publish
RemovePermission
SetSubscriptionAttributes
SetTopicAttributes
Subscribe
Unsubscribe

The AWSAccountIds and ActionNames parameters must have the same number of values. The actions correspond to the account IDs and only one action may be set for one account ID at a time. For instance:

component.AddPermission("myTopicArn", "myLabel", "1234567,7654321", "Publish,GetTopicAttributes");