Skip to content

Delete Policy Store Alias

verifiedpermissions_delete_policy_store_alias R Documentation

Deletes the specified policy store alias

Description

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.

Verified Permissions is eventually consistent. If you hard delete a policy store alias and then immediately recreate it to be associated with a different policy store, requests that reference this alias may continue to be evaluated against the previously associated policy store for a short period of time.

Usage

verifiedpermissions_delete_policy_store_alias(aliasName, deletionMode)

Arguments

aliasName

[required] Specifies the name of the policy store alias that you want to delete.

The alias name must always be prefixed with ⁠policy-store-alias/⁠.

deletionMode

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.

Value

An empty list.

Request syntax

svc$delete_policy_store_alias(
  aliasName = "string",
  deletionMode = "SoftDelete"|"HardDelete"
)