Updated on 2022-06-01 GMT+08:00

Deleting a Policy

Function

This API is used to delete a policy based on its ID. [It is not supported in versions later than 1.8.0.] (tag:hcs)

URI

DELETE /v1/{project_id}/pe/policy/{policy_id}

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Project ID

policy_id

Yes

String

Policy ID. The policy with this ID is to be deleted.

Request Parameters

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

Project-level token obtained from IAM.

Content-Type

Yes

String

Content type, which is application/json.

Enumeration values:

  • application/json

Response Parameters

Status code: 200

Table 3 Response body parameters

Parameter

Type

Description

errorCode

String

Error code.

errorMessage

String

Details.

Example Requests

Delete the policy whose ID is 1b9994f0-847a-45e4-aeee-e8b604dddb34.

DELETE https://{Endpoint}/v1/{project_id}/pe/policy/1b9994f0-847a-45e4-aeee-e8b604dddb34

N/A

Example Responses

None

Status Codes

Status Code

Description

200

OK: The request is successful.

400

Bad Request: Invalid request. The client should not repeat the request without modifications.

401

Unauthorized: The authorization information is incorrect or invalid.

403

Forbidden: The request is rejected. The server has received the request and understood it, but the server refuses to respond to it. The client should not repeat the request without modifications.

500

Internal Server Error: The server is able to receive the request but unable to understand the request.

503

Service Unavailable: The requested service is invalid. The client should not repeat the request without modifications.

Error Codes

See Error Codes.