add_permission Method
Adds a permission to a queue for a specific account, which allows for sharing access to the queue.
Syntax
def add_permission(queue_id: str, user_label: str, amazon_account: str, permission_name: str) -> str: ...
Remarks
This method adds a permission to the queue specified by QueueId for the user account specified by AmazonAccount. UserLabel is the unique identification of the permission you're granting, and is used when deleting the permission via the remove_permission method. The current list of values you may pass in the PermissionName parameter are listed below:
- SendMessage
- ReceiveMessage
- DeleteMessage
- ChangeMessageVisibility
- GetQueueAttributes
Note that when you create a queue, you have full control access rights for the queue. Only you (as owner of the queue) can grant or deny permissions to the queue.
on_add_permission writes an SQS-generated policy. If you want to write your own policy, use set_queue_attribute to upload your policy.
This method returns the RequestId contained in the Amazon response.