Prev		Next

AddGrant (Query)

The AddGrant operation gives the specified user permission to access the queue specified.

Validation

AddGrant requests are validated on the following:

The specified queue must exist.

Returns

Returns Success if the action succeeded or an error response if unsuccessful.

Request Parameters

Name	Description	Type	Value
`QueueName`	Specifies the queue the grant is applied to.	Required. The name of the queue, as specified when the queue was created.	MyQueue
`Grantee.EmailAddress`	The email address of the user receiving the grant.	Required. String.	email_alias@server_domain.com
`Permission`	The grant, or permission, to add for the grantee. See Access Control Overview for a list of available grants.	String.	`ReceiveMessage`

Sample AddGrant Request (Query)

The following sample demonstrates adding a ReceiveMessage grant for the specified queue.

Sample Request

http://queue.amazonaws.com/A29E9VSPHGOG23/queue2
?Action=AddGrant
&Version=2006-04-01
&AWSAccessKeyId=[ACCESS_KEY_ID]
&Expires=[TIME]
&Signature=[SIGNATURE]
&Grantee.EmailAddress=[EMAIL_ADDRESS]
&Permission=ReceiveMessage

Sample Response

<AddGrantResponse xmlns=http://access.amazonaws.com/doc/2006-01-01/>
    <ResponseStatus>
        <StatusCode>Success</StatusCode>
    </ResponseStatus>
</AddGrantResponse>