Amazon Simple Queue Service
API Reference (API Version 2012-11-05)
« PreviousNext »
View the PDF for this guide.Go to the AWS Discussion Forum for this product.Did this page help you?  Yes | No |  Tell us about it...

RemovePermission

Description

The RemovePermission action revokes any permissions in the queue policy that matches the Label parameter. Only the owner of the queue can remove permissions.

Request Parameters

The following table lists the special request parameters the action uses (in addition to the common request parameters listed in Common Query Parameters).

NameDescriptionRequired

Label

The identification of the permission you want to remove. This is the label you added in AddPermission.

Type: String (example: AliceSendMessage)

Default: None

Yes

Response Elements

The response contains no special elements besides the common elements listed in the Responses section in the Amazon SQS Developer Guide.

Special Errors

The action returns no errors besides the common errors listed in Common Errors.

Examples

The following example Query request removes the testLabel permission on the queue named testQueue.

Sample Request

http://sqs.us-east-1.amazonaws.com/123456789012/testQueue/
?Action=RemovePermission
&Label=testLabel
&Version=2009-02-01
&SignatureMethod=HmacSHA256
&Expires=2009-04-18T22%3A52%3A43PST
&AWSAccessKeyId=AKIAIOSFODNN7EXAMPLE
&SignatureVersion=2
&Signature=Dqlp3Sd6ljTUA9Uf6SGtEExwUQEXAMPLE

Sample Response

<RemovePermissionResponse>
    <ResponseMetadata>
        <RequestId>
            f8bdb362-6616-42c0-977a-ce9a8bcce3bb
        </RequestId>
    </ResponseMetadata>
</RemovePermissionResponse>