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 Request Parameters Common to All Actions).

Name Description Required

Name	Description	Required
`Label`	The identfication of the permission you want to remove. This is the label you added in AddPermission. Type: String (example: `AliceSendMessage`) Default: None	Yes

Label

The identfication 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 Structure of a Successful Response.

Special Errors

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

Examples

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

Sample Request

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

Sample Response

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

Related Actions

AddPermission