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

Unbinding Multiple Access Control Policies from APIs

Function

This API is used to unbind multiple access control policies from APIs.

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/acl-bindings[?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

acl_bindings

No

String Array

IDs of the access control policies to be unbound

Example request:

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

Response

Table 4 Parameter description

Parameter

Type

Description

success_count

Number

Number of successfully unbound access control policies

failure

Array

Error message and access control policies that fail to be unbound

Table 5 Parameter description of failure

Parameter

Type

Description

bind_id

String

ID of an access control policy that fails to be unbound

error_code

String

Error code

error_msg

String

Error message

api_id

String

ID of an API from which an access control policy fails to be unbound

api_name

String

Name of the API from which an access control policy fails to be unbound

Example response:
{
	"failure": [{
		"bind_id": "81efcfd94b8747a0b21e8c04144a4e8c",
		"error_code": "APIG.3010",
		"error_msg": "Access control policy binding record not found",
                "api_id": "81efcfd94b8747a0b21e8c04144a4e8c",
		"api_name": "api01"
	}],
	"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