delete-policy-version

Deletes the specified version from the specified managed policy.

You cannot delete the default version from a policy using this operation. To delete the default version from a policy, use delete-policy. To find out which version of a policy is marked as the default version, use list-policy-versions.

For information about versions for managed policies, refer to Versioning for managed policies in the IAM User Guide.

Refer to AWS API Documentation.

Refer to aws help for descriptions of global parameters.

Synopsis

delete-policy-version
--policy-arn <value>
--version-id <value>

Options

--policy-arn (string)

The Amazon Resource Name (ARN) of the IAM policy from which you want to delete a version.

For more information about ARNs, refer to Amazon Resource Names (ARNs) in the Amazon Web Services General Reference.

--version-id (string)

The policy version to delete.

This parameter allows (through its regex pattern) a string of characters that consists of the lowercase letter ‘v’ followed by one or two digits, and optionally followed by a period ‘.’ and a string of letters and digits.

For more information about managed policy versions, refer to Versioning for managed policies in the IAM User Guide.

Refer to aws help for descriptions of global parameters.

Examples

To delete a version of a managed policy:

This example deletes the version identified as v2 from the policy whose ARN is arn:aws:iam::123456789012:policy/MySamplePolicy:

aws iam delete-policy-version --policy-arn \
arn:aws:iam::123456789012:policy/MyPolicy \
--endpoint-url https://iam.<base-domain-name> \
--version-id v2

For more information, refer to Overview of IAM Policies in the Using IAM guide.

Output

None