调用DescribeNetworkAcls接口查看网络ACL列表。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeNetworkAcls |
要执行的操作,取值:DescribeNetworkAcls。 |
RegionId | String | 是 | cn-hangzhou |
网络ACL所属的地域。 您可以通过调用DescribeRegions接口获取地域ID。 |
NetworkAclId | String | 否 | nacl-bp1lhl0taikrbgnh**** |
网络ACL的ID。 |
NetworkAclName | String | 否 | acl-1 |
网络ACL的名称。 长度为2~128个字符,必须以字母或中文开头,可包含数字、下划线(_)和短横线(-),但不能以 |
VpcId | String | 否 | vpc-123456 |
网络ACL关联的VPC的ID。 |
ResourceType | String | 否 | VSwitch |
关联实例的类型。
|
ResourceId | String | 否 | vsw-bp1de348lntdwnhbg**** |
关联实例的ID。
|
PageNumber | Integer | 否 | 1 |
列表的页码,默认值为1。 |
PageSize | Integer | 否 | 10 |
分页查询时每页的行数,最大值为50,默认值为10。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | F7DDDC17-FA06-4AC2-8F35-59D2470FCFC1 |
请求ID。 |
TotalCount | String | 2 |
列表条目数。 |
PageNumber | String | 1 |
当前页码。 |
PageSize | String | 10 |
当前分页包含的条目数。 |
NetworkAcls | Array |
网络ACL的详细信息。 |
|
NetworkAclId | String | nacl-a2do9e413e0spxscd**** |
网络ACL的ID。 |
RegionId | String | cn-hangzhou |
网络ACL所属的地域。 |
NetworkAclName | String | acl-8 |
网络ACL的名称。 |
Description | String | This is my NetworkAcl. |
网络ACL的描述信息。 |
VpcId | String | vpc-a2d33rfpl72k5defr**** |
关联的VPC的ID。 |
CreationTime | String | 2019-04-25 11:44:17 |
网络ACL的创建时间。 |
Status | String | Available |
网络ACL的状态。
|
IngressAclEntries | Array |
入方向规则信息。 |
|
NetworkAclEntryId | String | nae-a2dk86arlydmezasw**** |
入方向规则条目的ID。 |
Policy | String | accept |
授权策略,取值:
|
Protocol | String | all |
传输层协议,取值:
|
SourceCidrIp | String | 10.0.0.0/24 |
源地址段。 |
Port | String | -1/-1 |
源端口范围。 |
EntryType | String | custom |
规则类型,取值:
|
NetworkAclEntryName | String | acl-3 |
入方向规则条目的名称。 |
Description | String | This is IngressAclEntries. |
入方向规则的描述信息。 |
EgressAclEntries | Array |
出方向规则信息。 |
|
NetworkAclEntryId | String | nae-a2d447uw4tillfvgb**** |
出方向规则条目的ID。 |
Policy | String | accept |
授权策略,取值:
|
Protocol | String | all |
传输层协议,取值:
|
DestinationCidrIp | String | 10.0.0.0/24 |
目的地址段。 |
Port | String | -1/-1 |
目的端口范围。 |
EntryType | String | custom |
规则类型,取值:
|
Description | String | This is EgressAclEntries. |
出方向规则的描述信息。 |
NetworkAclEntryName | String | acl-2 |
出方向规则条目的名称。 |
Resources | Array |
关联的资源。 |
|
ResourceId | String | vsw-bp1de348lntdwcdf**** |
关联资源的ID。 |
ResourceType | String | VSwitch |
关联资源的类型。 |
Status | String | BINDED |
关联资源的状态。
|
示例
请求示例
https://vpc.aliyuncs.com/?Action=DescribeNetworkAcls
&RegionId=cn-hangzhou
&<公共请求参数>
正常返回示例
XML
格式
<DescribeNetworkAclsResponse>
<PageNumber>1</PageNumber>
<TotalCount>2</TotalCount>
<PageSize>10</PageSize>
<RequestId>F7DDDC17-FA06-4AC2-8F35-59D2470FCFC1</RequestId>
<NetworkAcls>
<NetworkAcl>
<EgressAclEntries>
<EgressAclEntry>
<Port>-1/-1</Port>
<Policy>accept</Policy>
<NetworkAclEntryId>nae-a2d8hqm2ueaeucdvf****</NetworkAclEntryId>
<DestinationCidrIp>10.0.0.0/24</DestinationCidrIp>
<Protocol>all</Protocol>
</EgressAclEntry>
</EgressAclEntries>
<CreationTime>2019-04-25 11:44:17</CreationTime>
<Status>Available</Status>
<RegionId>cn-hangzhou</RegionId>
<IngressAclEntries>
<IngressAclEntry>
<SourceCidrIp>10.0.0.0/24</SourceCidrIp>
<Port>-1/-1</Port>
<Policy>accept</Policy>
<NetworkAclEntryId>nae-a2dv360rgpczdcdvf****</NetworkAclEntryId>
<Protocol>all</Protocol>
</IngressAclEntry>
</IngressAclEntries>
<VpcId>vpc-a2d33rfpl72k5cdvf****</VpcId>
<NetworkAclId>nacl-a2d504869xhaecdvf****</NetworkAclId>
<Resources>
</Resources>
</NetworkAcl>
<NetworkAcl>
<EgressAclEntries>
<EgressAclEntry>
<Port>-1/-1</Port>
<Policy>accept</Policy>
<NetworkAclEntryId>nae-a2d05l0auxh7icdvf****</NetworkAclEntryId>
<DestinationCidrIp>10.0.0.0/24</DestinationCidrIp>
<Protocol>all</Protocol>
</EgressAclEntry>
</EgressAclEntries>
<CreationTime>2019-04-25 11:44:14</CreationTime>
<Status>Available</Status>
<RegionId>cn-hangzhou</RegionId>
<IngressAclEntries>
<IngressAclEntry>
<SourceCidrIp>10.0.0.0/24</SourceCidrIp>
<Port>-1/-1</Port>
<Policy>accept</Policy>
<NetworkAclEntryId>nae-a2dy2eq7mudblcdvf****</NetworkAclEntryId>
<Protocol>all</Protocol>
</IngressAclEntry>
</IngressAclEntries>
<VpcId>vpc-a2d33rfpl72k5cdvf****</VpcId>
<NetworkAclId>nacl-a2detw6o77x7lcdvf****</NetworkAclId>
<Resources>
</Resources>
</NetworkAcl>
</NetworkAcls>
</DescribeNetworkAclsResponse>
JSON
格式
{
"PageNumber": 1,
"TotalCount": 2,
"PageSize": 10,
"RequestId": "F7DDDC17-FA06-4AC2-8F35-59D2470FCFC1",
"NetworkAcls": {"NetworkAcl": [
{
"EgressAclEntries": {"EgressAclEntry": [ {
"Port": "-1/-1",
"Policy": "accept",
"NetworkAclEntryId": "nae-a2d8hqm2ueaeucdvf****",
"DestinationCidrIp": "10.0.0.0/24",
"Protocol": "all"
}]},
"CreationTime": "2019-04-25 11:44:17",
"Status": "Available",
"RegionId": "cn-hangzhou",
"IngressAclEntries": {"IngressAclEntry": [ {
"SourceCidrIp": "10.0.0.0/24",
"Port": "-1/-1",
"Policy": "accept",
"NetworkAclEntryId": "nae-a2dv360rgpczdcdvf****",
"Protocol": "all"
}]},
"VpcId": "vpc-a2d33rfpl72k5cdvf****",
"NetworkAclId": "nacl-a2d504869xhaecdvf****",
"Resources": {"Resource": []}
},
{
"EgressAclEntries": {"EgressAclEntry": [ {
"Port": "-1/-1",
"Policy": "accept",
"NetworkAclEntryId": "nae-a2d05l0auxh7icdvf****",
"DestinationCidrIp": "10.0.0.0/24",
"Protocol": "all"
}]},
"CreationTime": "2019-04-25 11:44:14",
"Status": "Available",
"RegionId": "cn-hangzhou",
"IngressAclEntries": {"IngressAclEntry": [ {
"SourceCidrIp": "10.0.0.0/24",
"Port": "-1/-1",
"Policy": "accept",
"NetworkAclEntryId": "nae-a2dy2eq7mudblcdvf****",
"Protocol": "all"
}]},
"VpcId": "vpc-a2d33rfpl72k5cdvf****",
"NetworkAclId": "nacl-a2detw6o77x7lcdvf****",
"Resources": {"Resource": []}
}
]}
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
500 | InternalError | The request processing has failed due to some unknown error. | 请求处理由于某些未知错误失败。 |
访问错误中心查看更多错误码。