Skip to content

remove_permission

Operation

remove_permission

remove_permission(request: RemovePermissionInput | RemovePermissionInputDict | None = None, /, *, plugins: list[Plugin] | None = None, **kwargs: Unpack[RemovePermissionInputDict]) -> 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
request RemovePermissionInput | RemovePermissionInputDict | None

The input as a model or dictionary. Pass this or keyword arguments, not both.

None
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
**kwargs Unpack[RemovePermissionInputDict]

The input fields as keyword arguments.

{}

Returns:

Type Description
RemovePermissionOutput

An instance of RemovePermissionOutput.

remove_permission async

remove_permission(request: RemovePermissionInput | RemovePermissionInputDict | None = None, /, *, plugins: list[Plugin] | None = None, **kwargs: Unpack[RemovePermissionInputDict]) -> 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
request RemovePermissionInput | RemovePermissionInputDict | None

The input as a model or dictionary. Pass this or keyword arguments, not both.

None
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
**kwargs Unpack[RemovePermissionInputDict]

The input fields as keyword arguments.

{}

Returns:

Type Description
RemovePermissionOutput

An instance of RemovePermissionOutput.

Input

Pass the input as keyword arguments, a positional dictionary, or a positional model object. Pass plugins separately as a keyword argument.

RemovePermissionInputDict

Bases: TypedDict

Dictionary form of RemovePermissionInput.

Attributes

label instance-attribute
label: Required[str]

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

queue_url instance-attribute
queue_url: Required[str]

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

Queue URLs and names are case-sensitive.

RemovePermissionInput dataclass

Bases: _SerdeShape

Attributes

label class-attribute instance-attribute
label: str | None = ...

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

queue_url class-attribute instance-attribute
queue_url: str | None = ...

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

Queue URLs and names are case-sensitive.

Output

RemovePermissionOutput dataclass

Bases: _SerdeShape

Dataclass for RemovePermissionOutput structure.

Attributes

response_metadata class-attribute instance-attribute
response_metadata: ResponseMetadata = ...

Metadata about the response that produced this output. Use this to recover the request identifiers a service's support team needs in order to investigate a call. Members of the metadata are individually optional.