接口描述
您可以通过该接口查询网络ACL信息。
请求头
| 参数名称 |
类型 |
是否必须 |
描述 |
| X-Version |
String |
是 |
版本号，取值：2020-08-01 |
| X-Action |
String |
是 |
操作接口名，取值：DescribeNetworkAcls |
请求参数
| 参数名称 |
类型 |
是否必须 |
示例值 |
描述 |
| NamespaceId |
String |
是 |
default-UID |
命名空间ID |
| VpcId |
String |
是 |
458f4e89-6be0-4303-a31c-280895c07658 |
VPCID |
| NetworkAclIds |
String |
否 |
458f4e89-6be0-4303-a31c-280895c07658 |
网络ACL ID，如需查询多个实例，以 , 分隔； |
返回参数
| 参数名称 |
类型 |
示例值 |
描述 |
| RequestID |
String |
3a87cc31-efe6-487c-b28b-11bec3571e7d |
请求ID |
| Code |
String |
Success |
状态码,有InvalidParameter,Forbidden InternalError,Success四种状态 |
| NetworkAcls |
Array |
|
网络ACL列表 |
NetworkAcls
| 参数名称 |
类型 |
示例值 |
描述 |
| VpcId |
String |
458f4e89-6be0-4303-a31c-280895c07658 |
VPCID |
| NetworkAclId |
String |
458f4e89-6be0-4303-a31c-280895c07658 |
网络ACL ID |
| NetworkAclName |
String |
kenc_networkacl |
网络ACL名称 |
| NetworkAclEntries |
Array |
|
网络ACL规则列表 |
| VSwitchIds |
Array |
|
绑定的交换机列表 |
| CreateTime |
String |
2020-08-31T17:43:00Z |
ACL创建时间 |
NetworkAclEntries
| 参数名称 |
类型 |
示例值 |
描述 |
| NetworkAclEntryId |
String |
458f4e89-6be0-4303-a31c-280895c07658 |
网络ACL ID |
| NetworkAclEntryName |
String |
kenc_networkacl |
网络ACL名称 |
| Direction |
String |
in |
网络ACL规则方向，in为入站规则，out为出站规则。 |
| Protocol |
String |
ip |
tcp |
| CidrBlock |
String |
10.0.0.0/8 |
网络ACL规则网段 |
| Description |
String |
- |
网络ACL规则描述，命名规则如下：长度为小于128个字符 |
| DestinationPortRangeFrom |
Integer |
1-65535 |
TCP或者UDP协议规则的起始端口，范围为1-65535，只有协议为TCP/UDP类型时，才必填。 |
| DestinationPortRangeTo |
Integer |
1-65535 |
TCP或者UDP协议规则的结束端口，范围为1-65535，只有协议为TCP/UDP类型时，才必填。 |
VSwitchIds
| 参数名称 |
类型 |
示例值 |
描述 |
| VSwitchId |
String |
458f4e89-6be0-4303-a31c-280895c07658 |
交换机的ID |
请求示例
入参示例
curl --location --request GET
--header
--header
--header
--header
成功示例
{
"Code": "Success",
"RequestId": "3a87cc31-efe6-487c-b28b-11bec3571e7d",
"NetworkAcls":[
{
"NamespaceId":"demo",
"VpcId":"4a70ee3b-9a6e-4ae9-a982-1134d6ec1614",
"NetworkAclId":"0eeb9769-6117-4150-acd6-370ba798bdba",
"NetworkAclName":"kenc_networkacl",
"CreateTime": "2021-01-25T17:56:41+08:00",
"Description":"",
"NetworkAclEntries":[
{
"NetworkAclEntryId":"1",
"NetworkAclEntryName":"默认规则",
"Direction":"in",
"Protocol":"ip",
"Action":"drop",
"CidrBlock":"0.0.0.0/0"
},
{
"NetworkAclEntryId":"0",
"NetworkAclEntryName":"默认规则",
"Direction":"out",
"Protocol":"ip",
"Action":"drop",
"CidrBlock":"0.0.0.0/0"
}
],
"VSwitchIds":[
]
},
{
"NamespaceId":"demo",
"VpcId":"4a70ee3b-9a6e-4ae9-a982-1134d6ec1614",
"NetworkAclId":"aec90087-58dd-4551-b16a-49a9848449d2",
"NetworkAclName":"modify_acl_name",
"Description":"",
"NetworkAclEntries":[
{
"NetworkAclEntryId":"1",
"NetworkAclEntryName":"默认规则",
"Direction":"in",
"Protocol":"ip",
"Action":"drop",
"CidrBlock":"0.0.0.0/0"
},
{
"NetworkAclEntryId":"0",
"NetworkAclEntryName":"默认规则",
"Direction":"out",
"Protocol":"ip",
"Action":"drop",
"CidrBlock":"0.0.0.0/0"
}
],
"VSwitchIds":[
]
}
]
}
失败示例
{
"RequestId": "1312fefe-ca48-4d72-8521-cf5d2cf06b9c",
"Code": "InvalidParameter",
"Message": "Invalid param NamespaceId."
}
