You need to enable JavaScript to run this app.
文档中心
私有网络

私有网络

复制全文
下载 pdf
网络ACL
DescribeNetworkAclAttributes - 查询网络ACL详细信息
复制全文
下载 pdf
DescribeNetworkAclAttributes - 查询网络ACL详细信息
调用 DescribeNetworkAclAttributes 接口,查看指定网络ACL的详情。​
调试​
API Explorer
您可以通过 API Explorer 在线发起调用,无需关注签名生成过程,快速获取调用结果。
​
请求参数​
下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。​
Action String 必选 示例值:DescribeNetworkAclAttributes​
接口名称。当前 API 的名称为DescribeNetworkAclAttributes。​
​
Version String 必选 示例值:2020-04-01​
接口版本。当前 API 的版本为 2020-04-01。​
​
NetworkAclId String 必选 示例值:nacl-bp1fg655nh68xyz9****​
待查看网络ACL的ID。​
您可以调用 DescribeNetworkAcls 接口,查询网络ACL的ID。​
​
​
​
返回参数​
下方仅列出本接口特有的返回参数。更多信息请参见返回结构。​
RequestId String 示例值:2021062415303301022514515207C4****​
请求ID。​
​
NetworkAclAttribute Object 示例值:-​
网络ACL的详细信息。​
AccountId String 示例值:2000****​
网络ACL所属的主账号ID。​
​
NetworkAclId String 示例值:nacl-bp1fg655nh68xyz9****​
网络ACL的ID。​
​
NetworkAclName String 示例值:test-acl​
网络ACL名称。​
​
Description String 示例值:TestDescription​
网络ACL描述信息。​
​
VpcId String 示例值:vpc-bp67acfmxazb4p****​
网络ACL所属的VPC。​
​
Status String 示例值:Available​
网络ACL的状态。​
  • Available:可用​
  • Creating:创建中​
​
CreationTime String 示例值:2017-12-05T22:40:00+08:00​
创建网络ACL的时间。​
​
UpdateTime String 示例值:2017-12-05T22:40:00+08:00​
修改网络ACL的时间。​
​
ProjectName String 示例值:default​
网络ACL所属项目的名称。​
​
Tags Object[] 示例值:-​
网络ACL的标签信息。​
Key String 示例值:k1​
标签的标签键。​
​
Value String 示例值:v1​
标签的标签值。​
​
​
IngressAclEntries Object[] 示例值:-​
网络ACL入方向规则的信息。​
若存在多条入方向规则,返回结果按照入方向规则的优先级降序进行排序。​
NetworkAclEntryId String 示例值:nae-a2dk86arlydmezasw****​
入方向规则的ID。​
​
NetworkAclEntryName String 示例值:test-acl-1​
入方向规则的名称。​
​
Description String 示例值:This is IngressAclEntries.​
入方向规则的描述信息。​
​
Policy String 示例值:accept​
入方向规则的授权策略。​
  • accept:允许访问。​
  • drop:拒绝访问。不返回拒绝访问的信息,仅表现出发起端请求超时或类似无法建立连接的信息。​
​
SourceCidrIp String 示例值:10.XX.XX.0/24​
入方向规则源地址的网段。​
​
Protocol String 示例值:all​
协议类型。​
  • tcp:TCP协议。​
  • udp:UDP协议。​
  • icmp:ICMP协议。​
  • icmpv6:ICMPV6协议。​
  • gre:GRE协议。​
  • all:支持所有协议。​
​
Priority Integer 示例值:1​
入方向规则的优先级,数字越小,代表优先级越高。​
  • 取值范围:1 ~ 100​
  • 不填默认值:1​
​
Port String 示例值:-1/-1​
入方向规则的目的端口范围。​
  • 当入方向规则的Protocol为all、icmp或gre时,端口范围为-1/-1,表示不限制端口。​
  • 当入方向规则的Protocol为tcp或udp时,端口范围为1~65535,格式为1/200、80/80,表示端口1到端口200、端口80。​
​
​
EgressAclEntries Object[] 示例值:-​
网络ACL出方向规则的详细信息。​
若存在多条出方向规则,返回结果按照入方向规则的优先级降序进行排序。​
NetworkAclEntryId String 示例值:nae-a2d447uw4tillfvgb****​
出方向规则的ID。​
​
NetworkAclEntryName String 示例值:test-acl-1​
出方向规则的名称。​
​
Description String 示例值:This is EgressAclEntries.​
出方向规则的描述信息。​
​
Policy String 示例值:accept​
授权策略。​
  • accept:允许访问。​
  • drop:拒绝访问。不返回拒绝访问的信息,仅表现出发起端请求超时或类似无法建立连接的信息。​
​
DestinationCidrIp String 示例值:10.XX.XX.0/24​
目标地址的网段。​
​
Protocol String 示例值:all​
协议类型。​
  • tcp:TCP协议。​
  • udp:UDP协议。​
  • icmp:ICMP协议。​
  • icmpv6:ICMPV6协议。​
  • gre:GRE协议。​
  • all:支持所有协议。​
​
Priority Integer 示例值:1​
出方向规则的优先级,数字越小,代表优先级越高。​
  • 取值范围:1 ~ 100​
  • 不填默认值:1​
​
Port String 示例值:-1/-1​
出方向规则的目的端口范围。​
  • 当出方向规则的Protocol为all、icmp或gre时,端口范围为-1/-1,表示不限制端口。​
  • 当出方向规则的Protocol为tcp或udp时,端口范围为1~65535,格式为1/200、80/80,表示端口1到端口200、端口80。​
​
​
Resources Object[] 示例值:-​
网络ACL关联资源的详细信息。​
ResourceId String 示例值:subnet-bp1de348lntdwcdf****​
网络ACL关联资源的ID。​
​
Status String 示例值:BINDED​
网络ACL关联资源的状态。​
  • BINDED:已绑定。​
  • BINDING:绑定中。​
  • UNBINDING:解绑中。​
​
​
​
​
​
请求示例​
​
GET /?Action=DescribeNetworkAclAttributes&Version=2020-04-01&NetworkAclId=nacl-bp1fg655nh68xyz9**** HTTP/1.1​
Host: vpc.cn-beijing.volcengineapi.com​
X-Date: 20251121T094038Z​
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20251121/cn-beijing/vpc/request, SignedHeaders=host;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f​
​
返回示例​
​
{​
"ResponseMetadata": {​
"RequestId": "20230604110420****100232280022D31",​
"Action": "DescribeNetworkAclAttributes",​
"Version": "2020-04-01",​
"Service": "vpc",​
"Region": "cn-beijing"​
},​
"Result": {​
"NetworkAclAttribute": {​
"Tags": [​
{​
"Key": "k1",​
"Value": "v1"​
}​
],​
"VpcId": "vpc-bp67acfmxazb4p****",​
"Status": "Available",​
"AccountId": "2000****",​
"Resources": [​
{​
"Status": "BINDED",​
"ResourceId": "subnet-bp1de348lntdwcdf****"​
}​
],​
"UpdateTime": "2017-12-05T22:40:00+08:00",​
"Description": "TestDescription",​
"ProjectName": "default",​
"CreationTime": "2017-12-05T22:40:00+08:00",​
"NetworkAclId": "nacl-bp1fg655nh68xyz9****",​
"NetworkAclName": "test-acl",​
"EgressAclEntries": [​
{​
"Port": "-1/-1",​
"Policy": "accept",​
"Priority": 1,​
"Protocol": "all",​
"Description": "This is EgressAclEntries.",​
"DestinationCidrIp": "10.XX.XX.0/24",​
"NetworkAclEntryId": "nae-a2d447uw4tillfvgb****",​
"NetworkAclEntryName": "test-acl-1"​
}​
],​
"IngressAclEntries": [​
{​
"Port": "-1/-1",​
"Policy": "accept",​
"Priority": 1,​
"Protocol": "all",​
"Description": "This is IngressAclEntries.",​
"SourceCidrIp": "10.XX.XX.0/24",​
"NetworkAclEntryId": "nae-a2dk86arlydmezasw****",​
"NetworkAclEntryName": "test-acl-1"​
}​
]​
},​
"RequestId": "2021062415303301022514515207C4****"​
}​
}​
​
错误码​
​
状态码​
错误码​
错误信息​
说明​
400​
DryRunOperation​
Exception raised to indicate a successfully authorized action when the DryRun flag is set to true.​
该请求设置为DryRun操作,操作授权已获得许可,但未被实际执行。​
404​
InvalidNetworkAcl.NotFound​
The specified Network ACL does not exist.​
指定的网络ACL不存在。​
​
​
最近更新时间:2026.02.09 16:06:05
这个页面对您有帮助吗?
有用
有用
无用
无用