SQS > Operations > remove_permission

remove_permission¶

Operation¶

remove_permission(input: RemovePermissionInput, plugins: list[Plugin] | None = None) -> RemovePermissionOutput

Revokes any permissions in the queue policy that matches the specified Label parameter.

Note

Only the owner of a queue can remove permissions from it.
Cross-account permissions don't apply to this action. For more information, see Grant cross-account permissions to a role and a username in the Amazon SQS Developer Guide.
To remove the ability to change queue permissions, you must deny permission to the AddPermission, RemovePermission, and SetQueueAttributes actions in your IAM policy.

Parameters:

Name	Type	Description	Default
`input`	`RemovePermissionInput`	An instance of `RemovePermissionInput`.	required
`plugins`	`list[Plugin] \| None`	A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations.	`None`

Returns:

Type	Description
`RemovePermissionOutput`	An instance of `RemovePermissionOutput`.

label: str | None = None

The identification of the permission to remove. This is the label added using the ``AddPermission`` action.

queue_url: str | None = None

The URL of the Amazon SQS queue from which permissions are removed.

Queue URLs and names are case-sensitive.

Dataclass for RemovePermissionOutput structure.