Creates an access control list.

You can create multiple access control lists. Each list can contain multiple IP addresses and CIDR blocks. Before you create an access control list, note the following limits:

  • Each Alibaba Cloud account can create a maximum of 50 access control lists per region.
  • Each Alibaba Cloud account can add a maximum of 50 IP addresses at a time.
  • Each access control list can contain a maximum of 300 IP entries.
  • Each listener can be associated with a maximum of 50 access control lists.

Debug

Use OpenAPI Explorer to perform debug operations and generate SDK code examples.

Request parameters

Parameter Type Required? Example value Description
Action String Yes CreateAccessControlList

The name of this action. Value: CreateAccessControlList

AclName String Yes rule1

The name of the access control list. The name must be unique in a region.

RegionId String Yes cn-hangzhou

The ID of the region to which the access control list belongs.

AddressIPVersion String No ipv4

Optional. The IP version, which can be set to ipv4 or ipv6.

Note Currently, IPv6 instances are supported only in the following zones: zones E and F in the China (Hangzhou) region, zones F and G in the China (Beijing) region, all zones in the China (Shanghai) region, and zones D and E in the China (Shenzhen) region. Also, the IPv6 instances must be performance-guaranteed instances.

Response parameters

Parameter Type Example value Description
AclId String acl-rj9xpxzcwxrukois65yw3

The ID of the access control list.

RequestId String 988CB45E-1643-48C0-87B4-928DDF77EA49

The ID of the request.

Examples

Request example


http(s)://[Endpoint]/? Action=CreateAccessControlList
&AclName=rule1
&RegionId=cn-hangzhou
&<CommonParameters>

Response examples

XML format

<CreateAccessControlListResponse>
  <RequestId>988CB45E-1643-48C0-87B4-928DDF77EA49</RequestId>
  <AclId>acl-rj9xpxzcwxrukois65yw3</AclId>
</CreateAccessControlListResponse>

JSON format

{
	"AclId":"acl-rj9xpxzcwxrukois65yw3",
	"RequestId":"988CB45E-1643-48C0-87B4-928DDF77EA49"
}

Error codes

See common error codes.