RemovePermission
Removes a statement from a topic's access control policy.
Note
To remove the ability to change topic permissions, you must deny permissions to
the AddPermission
, RemovePermission
, and
SetTopicAttributes
actions in your IAM policy.
Request Parameters
For information about the parameters that are common to all actions, see Common Parameters.
- Label
-
The unique label of the statement you want to remove.
Type: String
Required: Yes
- TopicArn
-
The ARN of the topic whose access control policy you wish to modify.
Type: String
Required: Yes
Errors
For information about the errors that are common to all actions, see Common Errors.
- AuthorizationError
-
Indicates that the user has been denied access to the requested resource.
HTTP Status Code: 403
- InternalError
-
Indicates an internal service error.
HTTP Status Code: 500
- InvalidParameter
-
Indicates that a request parameter does not comply with the associated constraints.
HTTP Status Code: 400
- NotFound
-
Indicates that the requested resource does not exist.
HTTP Status Code: 404
Examples
The structure of AUTHPARAMS
depends on the signature of the API request.
For more information, see Examples
of the complete Signature Version 4 signing process (Python) in the
AWS General Reference.
Example
This example illustrates one usage of RemovePermission.
Sample Request
https://sns.us-east-2.amazonaws.com/?Action=RemovePermission
&TopicArn=arn%3Aaws%3Asns%3Aus-east-2%3A123456789012%3AMy-Test
&Label=NewPermission
&Version=2010-03-31
&AUTHPARAMS
Sample Response
<RemovePermissionResponse xmlns="https://sns.amazonaws.com/doc/2010-03-31/">
<ResponseMetadata>
<RequestId>d170b150-33a8-11df-995a-2d6fbe836cc1</RequestId>
</ResponseMetadata>
</RemovePermissionResponse>
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: