Creates a network ACL.
Try it now
Test
RAM authorization
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| VpcId |
string |
Yes |
The ID of the virtual private cloud (VPC) to which the network ACL belongs. If the VPC contains Elastic Compute Service (ECS) instances of the following instance families, you must upgrade or release them before you can create a network ACL for the VPC. ecs.c1, ecs.c2, ecs.c4, ecs.c5, ecs.ce4, ecs.cm4, ecs.d1, ecs.e3, ecs.e4, ecs.ga1, ecs.gn4, ecs.gn5, ecs.i1, ecs.m1, ecs.m2, ecs.mn4, ecs.n1, ecs.n2, ecs.n4, ecs.s1, ecs.s2, ecs.s3, ecs.se1, ecs.sn1, ecs.sn2, ecs.t1, and ecs.xn4.
Note
If the VPC contains an ECS instance that does not support network ACLs, upgrade the ECS instance. |
vpc-dsfd34356vdf**** |
| NetworkAclName |
string |
No |
The name of the network ACL. The name must be 1 to 128 characters in length, and cannot start with |
acl-1 |
| Description |
string |
No |
The description of the network ACL. The description must be 1 to 256 characters in length, and cannot start with |
This is my NetworkAcl. |
| ClientToken |
string |
No |
The client token used to ensure the idempotence of the request. You can use the client to generate the token, but the token must be unique among requests. The token can contain only ASCII characters. Note
If you do not specify this parameter, the system automatically uses the request ID as the client token. The request ID may be different for each request. |
0c593ea1-3bea-11e9-b96b-88e9fe637760 |
| DryRun |
boolean |
No |
Whether to perform only a dry run, without performing the actual request. Valid values:
|
false |
| Tag |
array<object> |
No |
The tags of the resource. |
|
|
object |
No |
|||
| Key |
string |
No |
The key of tag N to add to the resource. You can specify up to 20 tag keys. The tag key cannot be an empty string. The tag key can be up to 128 characters in length. It cannot start with |
FinanceDept |
| Value |
string |
No |
The value of tag N to add to the resource. You can specify at most 20 tag values. The tag value can be an empty string. The tag value can be up to 128 characters in length and cannot contain |
FinanceJoshua |
| RegionId |
string |
Yes |
The region ID of the network ACL. You can call the DescribeRegions operation to query the most recent region list. |
cn-hangzhou |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
|||
| NetworkAclId |
string |
The ID of the network ACL. |
nacl-a2do9e413e0spzasx**** |
| RequestId |
string |
The request ID. |
0ED8D006-F706-4D23-88ED-E11ED28DCAC0 |
| NetworkAclAttribute |
object |
The attributes of the network ACL. |
|
| Status |
string |
The status of the network ACL. Valid values:
|
Modifying |
| VpcId |
string |
The ID of the VPC to which the network ACL belongs. |
vpc-a2d33rfpl72k5xsscd**** |
| CreationTime |
string |
The time when the network ACL was created. |
2021-12-25 11:33:27 |
| Description |
string |
The description of the network ACL. |
This is my NetworkAcl. |
| NetworkAclName |
string |
The name of the network ACL. |
acl-1 |
| NetworkAclId |
string |
The ID of the network ACL. |
nacl-a2do9e413e0spdefr**** |
| RegionId |
string |
The region ID of the network ACL. |
cn-hangzhou |
| IngressAclEntries |
object |
||
| IngressAclEntry |
array<object> |
The inbound rules. |
|
|
object |
|||
| NetworkAclEntryId |
string |
The ID of the inbound rule. |
nae-a2dk86arlydmexscd**** |
| NetworkAclEntryName |
string |
The name of the inbound rule. |
acl-3 |
| Policy |
string |
The action to be performed on network traffic that matches the rule. Valid values:
|
accept |
| Description |
string |
The description of the inbound rule. |
This is IngressAclEntries. |
| SourceCidrIp |
string |
The source CIDR block. |
10.0.0.0/24 |
| Protocol |
string |
The protocol. Valid values:
|
all |
| Port |
string |
The destination port range of the inbound traffic.
|
-1/-1 |
| EgressAclEntries |
object |
||
| EgressAclEntry |
array<object> |
The outbound rules. |
|
|
object |
|||
| NetworkAclEntryId |
string |
The ID of the outbound rule. |
nae-a2d447uw4tillxsdc**** |
| NetworkAclEntryName |
string |
The name of the outbound rule. |
acl-2 |
| Policy |
string |
The action to be performed on network traffic that matches the rule. Valid values:
|
accept |
| Description |
string |
The description of the outbound rule. |
This is EgressAclEntries. |
| Protocol |
string |
The protocol. Valid values:
|
all |
| DestinationCidrIp |
string |
The destination CIDR block. |
10.0.0.0/24 |
| Port |
string |
The destination port range of the outbound traffic.
|
-1/-1 |
| Resources |
object |
||
| Resource |
array<object> |
The information about the associated resources. |
|
|
object |
|||
| Status |
string |
The association status of the resource. Valid values:
|
BINDED |
| ResourceType |
string |
The type of resource with which you want to associate the network ACL. |
vSwitch |
| ResourceId |
string |
The ID of the associated resource. |
vsw-bp1de348lntdwgthy**** |
Examples
Success response
JSON format
{
"NetworkAclId": "nacl-a2do9e413e0spzasx****",
"RequestId": "0ED8D006-F706-4D23-88ED-E11ED28DCAC0",
"NetworkAclAttribute": {
"Status": "Modifying",
"VpcId": "vpc-a2d33rfpl72k5xsscd****",
"CreationTime": "2021-12-25 11:33:27",
"Description": "This is my NetworkAcl.",
"NetworkAclName": "acl-1\t",
"NetworkAclId": "nacl-a2do9e413e0spdefr****",
"RegionId": "cn-hangzhou\t",
"IngressAclEntries": {
"IngressAclEntry": [
{
"NetworkAclEntryId": "nae-a2dk86arlydmexscd****",
"NetworkAclEntryName": "acl-3\t",
"Policy": "accept",
"Description": "This is IngressAclEntries.\t",
"SourceCidrIp": "10.0.0.0/24\t",
"Protocol": "all",
"Port": "-1/-1"
}
]
},
"EgressAclEntries": {
"EgressAclEntry": [
{
"NetworkAclEntryId": "nae-a2d447uw4tillxsdc****",
"NetworkAclEntryName": "acl-2",
"Policy": "accept",
"Description": "This is EgressAclEntries.",
"Protocol": "all",
"DestinationCidrIp": "10.0.0.0/24",
"Port": "-1/-1\t"
}
]
},
"Resources": {
"Resource": [
{
"Status": "BINDED",
"ResourceType": "VSwitch",
"ResourceId": "vsw-bp1de348lntdwgthy****"
}
]
}
}
}
Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | ParameterMissing.AliUid | ParameterMissing.AliUid | |
| 400 | ParameterMissing.Bid | ParameterMissing.Bid | |
| 400 | ParameterMissing.RegionId | ParameterMissing.RegionId | |
| 400 | ParameterEmpty.RegionId | ParameterEmpty.RegionId | |
| 400 | ParameterMissing.VpcId | ParameterMissing.VpcId | |
| 400 | ParameterLengthIllegal.Name | ParameterLengthIllegal.Name | The length of the rule name is invalid. |
| 400 | ParameterIllegal.Name | ParameterIllegal.Name | The name of the entry is invalid. |
| 400 | ParameterLengthIllegal.Description | ParameterLengthIllegal.Description | |
| 400 | ParameterIllegal.Description | ParameterIllegal.Description | |
| 400 | ParameterEmpty.VpcId | ParameterEmpty.VpcId | |
| 400 | InvalidVpcId.NotFound | The vpc is not exist. | |
| 400 | QuotaExceed.NetworkAcl | Network acl is over limit. | |
| 400 | NotSupport.NetworkAcl | Network acl is not support now. | |
| 400 | IllegalParamFormat.%s | The param format of %s is illegal. | The parameter mode is invalid. |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.