Help Center> API Gateway> API Reference> Shared Gateway APIs (for Existing Users)> Access Control Policy Management> Querying Details of an Access Control Policy
View PDF

Querying Details of an Access Control Policy

Function

This API is used to query the details of a specified access control policy.

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

GET

/v1.0/apigw/acls/{id}

The following table lists the parameter in the URI.

Table 2 Parameter description

Parameter

Mandatory

Type

Description

id

Yes

String

Access control policy ID

Request

N/A

Response

Table 3 Parameter description

Parameter

Type

Description

id

String

Access control policy ID

acl_name

String

Access control policy name

acl_type

String

Access control type, which can be:

  • PERMIT (whitelist)
  • DENY (blacklist)

acl_value

String

Access control objects

entity_type

String

Object type, which can be:

  • IP
  • DOMAIN

update_time

Timestamp

Time when the access control policy was last updated

Example response:

{
	"id": "d402b35e-1054-4280-b1c5-0d741a28c995",
	"acl_name": "goodone",
	"entity_type": "DOMAIN",
	"acl_type": "PERMIT",
	"acl_value": "19asdfaf-adfadf",
	"update_time": "2017-11-18T14:27:36.918578+08:00"
}

Status Codes

Table 4 Status codes

Status Code

Description

200

OK

400

Bad Request

403

Forbidden

404

Not Found