Skip to content

DynamoDB  >  Operations  >  delete_resource_policy

delete_resource_policy

Operation

delete_resource_policy async

delete_resource_policy(input: DeleteResourcePolicyInput, plugins: list[Plugin] | None = None) -> DeleteResourcePolicyOutput

Deletes the resource-based policy attached to the resource, which can be a table or stream.

DeleteResourcePolicy is an idempotent operation; running it multiple times on the same resource doesn't result in an error response, unless you specify an ExpectedRevisionId, which will then return a PolicyNotFoundException.

Warning

To make sure that you don't inadvertently lock yourself out of your own resources, the root principal in your Amazon Web Services account can perform DeleteResourcePolicy requests, even if your resource-based policy explicitly denies the root principal's access.

Note: DeleteResourcePolicy is an asynchronous operation. If you issue a GetResourcePolicy request immediately after running the DeleteResourcePolicy request, DynamoDB might still return the deleted policy. This is because the policy for your resource might not have been deleted yet. Wait for a few seconds, and then try the GetResourcePolicy request again.

Parameters:

Name Type Description Default
input DeleteResourcePolicyInput

An instance of DeleteResourcePolicyInput.

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
DeleteResourcePolicyOutput

An instance of DeleteResourcePolicyOutput.

Input

DeleteResourcePolicyInput dataclass

Dataclass for DeleteResourcePolicyInput structure.

Attributes

expected_revision_id class-attribute instance-attribute
expected_revision_id: str | None = None

A string value that you can use to conditionally delete your policy. When you provide an expected revision ID, if the revision ID of the existing policy on the resource doesn't match or if there's no policy attached to the resource, the request will fail and return a PolicyNotFoundException.

resource_arn class-attribute instance-attribute
resource_arn: str | None = None

The Amazon Resource Name (ARN) of the DynamoDB resource from which the policy will be removed. The resources you can specify include tables and streams. If you remove the policy of a table, it will also remove the permissions for the table's indexes defined in that policy document. This is because index permissions are defined in the table's policy.

Output

DeleteResourcePolicyOutput dataclass

Dataclass for DeleteResourcePolicyOutput structure.

Attributes

revision_id class-attribute instance-attribute
revision_id: str | None = None

A unique string that represents the revision ID of the policy. If you're comparing revision IDs, make sure to always use string comparison logic.

This value will be empty if you make a request against a resource without a policy.