Updated on 2024-11-18 GMT+08:00

Deleting a Custom Policy

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.

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