All Products
Search
Document Center

Key Management Service:DeletePolicy

Last Updated:Aug 28, 2026

Deletes a permission policy.

Operation description

Before you delete a permission policy, make sure that it is not associated with any application access points (AAPs). Otherwise, the associated applications cannot access Key Management Service (KMS).

For more information about the permissions required for a RAM user or RAM role to call this operation, see Resource Access Management.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter

Type

Required

Description

Example

Name

string

Yes

The name of the permission policy that you want to delete.

policy_test

Response elements

Element

Type

Description

Example

object

RequestId

string

The request ID.

00a26a33-d992-42f3-9012-5fd12764430f

Examples

Success response

JSON format

{
  "RequestId": "00a26a33-d992-42f3-9012-5fd12764430f"
}

Error codes

HTTP status code

Error code

Error message

Description

400 InvalidParameter The specified parameter is not valid. An invalid value is specified for the parameter.
404 InvalidAccessKeyId.NotFound The Access Key ID provided does not exist in our records.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.