2026/05/21 - Amazon Verified Permissions - 1 updated api methods
Changes Support hard deleting policy store aliases. Users can now delete an alias and immediately reassign it to a different policy store without waiting for the soft-delete retention period.
{'deletionMode': 'SoftDelete | HardDelete'}
Deletes the specified policy store alias.
This operation is idempotent. If you specify a policy store alias that does not exist, the request response will still return a successful HTTP 200 status code.
By default, when a policy store alias is deleted, it enters the PendingDeletion state. When a policy store alias is in the PendingDeletion state, new policy store aliases cannot be created with the same name. If the policy store alias is used in an API that has a policyStoreId field, the operation will fail with a ResourceNotFound exception.
To immediately delete a policy store alias and bypass the PendingDeletion state, set the deletionMode parameter to HardDelete.
See also: AWS API Documentation
Request Syntax
client.delete_policy_store_alias(
aliasName='string',
deletionMode='SoftDelete'|'HardDelete'
)
string
[REQUIRED]
Specifies the name of the policy store alias that you want to delete.
string
Specifies the deletion mode for the policy store alias. The valid values are:
SoftDelete – The policy store alias enters the PendingDeletion state. This is the default behavior when no deletionMode is specified.
HardDelete – The policy store alias is immediately deleted, bypassing the PendingDeletion state.
dict
Response Syntax
{}
Response Structure
(dict) --