Updated on 2022-02-21 GMT+08:00

Deleting Multiple Access Control Policies

Function

This API is used to delete multiple access control policies.

Access control policies bound to APIs cannot be deleted.

URI

The following table lists the HTTP/HTTPS request method and URI of the API.

Table 1 HTTP/HTTPS request method and URI

Request Method

URI

PUT

/v1.0/apigw/acls[?action]

The following table lists the parameter in the URI.

Table 2 Parameter description

Parameter

Mandatory

Type

Description

action

Yes

String

The value must be delete.

Request

Table 3 Parameter description

Parameter

Mandatory

Type

Description

acls

No

String Array

IDs of the access control policies to be deleted

Example request:

{
    "acls": ["81efcfd94b8747a0b21e8c04144a4e8c","7addcd00cfab433984b1d8bf2fe08aaa"]
}

Response

Table 4 Parameter description

Parameter

Type

Description

success_count

Number

Number of successfully deleted access control policies

failure

Array

Error message and access control policies that fail to be deleted

Table 5 Parameter description of failure

Parameter

Type

Description

acl_id

String

ID of an access control policy that fails to be deleted

acl_name

String

Name of the access control policy

error_code

String

Error code

error_msg

String

Error message

Example response:

{
	"failure": [{
		"ac;_id": "81efcfd94b8747a0b21e8c04144a4e8c",
                "acl_name": "acl1",
		"error_code": "APIG.3447",
		"error_msg": "The Acl Strategy has already binded to APIs"
	}],
	"success_count": 3
}

Status Codes

Table 6 Status codes

Status Code

Description

200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Server Internal Error