AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

Adds a statement to a topic's access control policy, granting access for the specified Amazon Web Services accounts to the specified actions.

To remove the ability to change topic permissions, you must deny permissions to the AddPermission, RemovePermission, and SetTopicAttributes actions in your IAM policy.

Note:

For .NET Core this operation is only available in asynchronous form. Please refer to AddPermissionAsync.

Namespace: Amazon.SimpleNotificationService
Assembly: AWSSDK.SimpleNotificationService.dll
Version: 3.x.y.z

Syntax

C#
public virtual AddPermissionResponse AddPermission(
         String topicArn,
         String label,
         List<String> awsAccountId,
         List<String> actionName
)

Parameters

topicArn
Type: System.String

The ARN of the topic whose access control policy you wish to modify.

label
Type: System.String

A unique identifier for the new policy statement.

awsAccountId
Type: System.Collections.Generic.List<System.String>

The Amazon Web Services account IDs of the users (principals) who will be given access to the specified actions. The users must have Amazon Web Services account, but do not need to be signed up for this service.

actionName
Type: System.Collections.Generic.List<System.String>

The action you want to allow for the specified principal(s). Valid values: Any Amazon SNS action name, for example Publish.

Return Value


The response from the AddPermission service method, as returned by SimpleNotificationService.

Exceptions

ExceptionCondition
AuthorizationErrorException Indicates that the user has been denied access to the requested resource.
InternalErrorException Indicates an internal service error.
InvalidParameterException Indicates that a request parameter does not comply with the associated constraints.
NotFoundException Indicates that the requested resource does not exist.

Version Information

.NET Framework:
Supported in: 4.5 and newer, 3.5

See Also