Help Center> API Gateway> API Reference> Dedicated Gateway APIs (V1) (To Be Deprecated)> Binding Access Control Policies> Unbinding Multiple Access Control Policies from APIs
View PDF

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/{project_id}/apigw/instances/{instance_id}/acl-bindings[?action]

The following table lists the parameters in the URI.

Table 2 Parameter description

Parameter

Mandatory

Type

Description

project_id

Yes

String

Project ID, which can be obtained by the administrator on the My Credentials page.

instance_id

Yes

String

Instance ID, which can be obtained from the dedicated gateway information on the API Gateway console.

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