RemoveGrant (Query)

The RemoveGrant action revokes a grant (permission) for the use of the specified queue. Only the owner of the queue, or grantee with FullControl permissions for the queue, can add or remove grants.

RemoveGrant requests are validated on the following:

Returns Success if successful or an error response if unsuccessful.

NameDescriptionTypeValue
QueueNameSpecifies the queue to which the grant is currently applied.Required. The name of the queue, as specified when the queue was created.MyQueue
Grantee.EmailAddressThe email address of the user who is losing the grant.Either Grantee.EmailAddress or Grantee.ID is required. String.email_alias@server_domain.com
Grantee.IDThe ID of the user (returned by ListGrants) from which the grant is removed.Either Grantee.EmailAddress or Grantee.ID is required. String.79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be
PermissionThe grant, or permission, to remove for the grantee. See Access Control Overview for a list of available grants.String.ReceiveMessage

The following example RemoveGrant request removes ReceiveMessage access rights on the queue named queue2 from the user with the specified email address.