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

私有网络

复制全文
下载 pdf
子网
DescribeSubnetAttributes - 查询子网详细信息
复制全文
下载 pdf
DescribeSubnetAttributes - 查询子网详细信息
调用 DescribeSubnetAttributes 接口,查看指定子网的详细信息。​
调试​
API Explorer
您可以通过 API Explorer 在线发起调用,无需关注签名生成过程,快速获取调用结果。
​
请求参数​
下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。​
Action String 必选 示例值:DescribeSubnetAttributes​
接口名称。当前 API 的名称为DescribeSubnetAttributes。​
​
Version String 必选 示例值:2020-04-01​
接口版本。当前 API 的版本为 2020-04-01。​
​
SubnetId String 必选 示例值:subnet-23dscddcffvf3****​
子网的ID。​
您可以调用 DescribeSubnets 接口,查询子网的ID。​
​
​
​
返回参数​
下方仅列出本接口特有的返回参数。更多信息请参见返回结构。​
AccountId String 示例值:210000****​
当前所属账号的ID。​
​
RequestId String 示例值:2021062415303301022514515207C4****​
请求ID。​
​
SubnetId String 示例值:subnet-25bcdxs7pv1****​
子网的ID。​
​
VpcId String 示例值:vpc-257gcdcdq64****​
子网所属VPC的ID。​
​
Status String 示例值:Available​
当前子网的状态。​
  • Pending:表示配置中。​
  • Available:表示可用。​
​
CidrBlock String 示例值:172.XX.XX.0/24​
子网的IPv4网段。​
​
Ipv6CidrBlock String 示例值:2408:XXXX:0:a600::/64​
子网的IPv6网段。​
说明​
IPv6功能正在邀测中,暂仅支持完成 企业认证 的账号申请试用,如需试用,请联系客户经理。​
​
ZoneId String 示例值:cn-beijing-a​
子网所属的可用区。​
​
AvailableIpAddressCount Integer 示例值:1​
子网中可用的IP地址数量。​
​
Description String 示例值:Description​
子网的描述信息。​
​
SubnetName String 示例值:subnet-1​
子网的名称。​
​
CreationTime String 示例值:2018-01-18T12:43:57+08:00​
子网的创建时间​
​
RouteTable Object 示例值:-​
路由表信息。​
RouteTableId String 示例值:vrt-bp145q7glnuzdv****​
子网关联的路由表ID。​
​
RouteTableType String 示例值:System​
子网关联的路由表的类型。​
  • System:表示系统路由表。​
  • Custom:表示自定义路由表。​
​
​
UpdateTime String 示例值:2021-01-11T10:23:57+08:00​
子网的更新时间。​
​
TotalIpv4Count Integer 示例值:253​
子网下可用IP总数。​
​
NetworkAclId String 示例值:acl-bp1fg655nh68xyz9****​
子网关联的网络ACL的ID。​
​
ProjectName String 示例值:default​
当前子网所属项目的名称。​
​
Tags Object[] 示例值:-​
子网的标签信息。​
Key String 示例值:k1​
标签的标签键。​
​
Value String 示例值:v1​
标签的标签值。​
​
​
IsDefault Boolean 示例值:false​
该子网是否为默认子网。​
  • true:默认子网,表示该子网是创建ECS实例时系统自动创建的子网。​
  • false:非默认子网,表示该子网是用户手动创建的。​
​
​
​
请求示例​
​
GET /?Action=DescribeSubnetAttributes&Version=2020-04-01&SubnetId=subnet-23dscddcffvf3**** 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": "DescribeSubnetAttributes",​
"Version": "2020-04-01",​
"Service": "vpc",​
"Region": "cn-beijing"​
},​
"Result": {​
"AccountId": "210000****",​
"AvailableIpAddressCount": 1,​
"CidrBlock": "172.XX.XX.0/24",​
"CreationTime": "2018-01-18T12:43:57+08:00",​
"Description": "Description",​
"Ipv6CidrBlock": "2408:XXXX:0:a600::/64",​
"IsDefault": false,​
"NetworkAclId": "acl-bp1fg655nh68xyz9****",​
"ProjectName": "default",​
"RequestId": "2021062415303301022514515207C4****",​
"RouteTable": {​
"RouteTableId": "vrt-bp145q7glnuzdv****",​
"RouteTableType": "System"​
},​
"Status": "Available",​
"SubnetId": "subnet-25bcdxs7pv1****",​
"SubnetName": "subnet-1",​
"Tags": [​
{​
"Key": "k1",​
"Value": "v1"​
}​
],​
"TotalIpv4Count": 253,​
"UpdateTime": "2021-01-11T10:23:57+08:00",​
"VpcId": "vpc-257gcdcdq64****",​
"ZoneId": "cn-beijing-a"​
}​
}​
​
错误码​
​
状态码​
错误码​
错误信息​
说明​
400​
DryRunOperation​
Exception raised to indicate a successfully authorized action when the DryRun flag is set to true.​
该请求设置为DryRun操作,操作授权已获得许可,但未被实际执行。​
404​
InvalidSubnet.NotFound​
The specified subnet does not exist.​
指定的子网不存在。​
​
​
最近更新时间:2026.02.06 17:03:54
这个页面对您有帮助吗?
有用
有用
无用
无用