Help Center/ Identity and Access Management/ API Reference/ API/ Custom Policy Management/ Deleting a Custom Policy - DeleteCustomPolicy
Updated on 2025-12-27 GMT+08:00
View PDF
Share

Deleting a Custom Policy - DeleteCustomPolicy

Function

This API is provided for the administrator to delete a custom policy.

The API can be called using both the global endpoint and region-specific endpoints. For IAM endpoints, see Regions and Endpoints.

Debugging

You can debug this API in API Explorer.

Authorization Information

Each account is authorized to call all APIs, but its IAM users must obtain the required permissions. For details, see Permissions and Supported Actions.

URI

DELETE /v3.0/OS-ROLE/roles/{role_id}

Table 1 URI parameters

Parameter

Mandatory

Type

Description

role_id

Yes

String

Custom policy ID. For details about how to obtain a custom policy ID, see Custom Policy ID.

Request Parameters

Table 2 Parameters in the request header

Parameter

Mandatory

Type

Description

Content-Type

Yes

String

Fill application/json;charset=utf8 in this field.

X-Auth-Token

Yes

String

Access token issued to a user to bear its identity and permissions.

For details about the permissions required by the token, see Actions.

Response Parameters

Table 3 Parameters in the response body

Parameter

Type

Description

message

String

Response message

Example Request

Request for deleting a custom policy

DELETE https://iam.myhuaweicloud.com/v3.0/OS-ROLE/roles/{role_id}

Example Response

{ 
  "message":"Delete success"
}

Status Codes

Status Code

Description

200

The custom policy is deleted successfully.

400

Invalid parameters.

401

Authentication failed.

403

Access denied.

500

Internal server error.

Error Codes

None

Parent topic: Custom Policy Management