查询子网列表
更新时间 2026-03-12 13:56:31
最近更新时间: 2026-03-12 13:56:31
接口功能介绍
查询子网列表
接口约束
无
URI
POST /v1/applicationAccessPointManage/listSubnet
路径参数 无
Query参数 无
请求参数
请求头header参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| regionId | 是 | String | 资源池id | fecnjniakfkn2314ndekqldedcsadfg |
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| vpcId | 是 | String | vpc id | vpc-w6sty9v8rr | |
| epId | 是 | String | 企业项目id | 1 | |
| regionToCheck | 否 | String | regionId | cn-hangzhou |
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| statusCode | String | 状态码 取值范围：200 成功 | 200 | |
| message | String | 提示信息 | Success | |
| returnObj | Object | 返回数据结构体 | result | |
| error | String | 错误码 仅错误时返回 格式为{服务编码}.{错误编号} | KMS.0269 |
表 result
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| list | Array of Objects | 子网列表 | subnetList |
表 subnetList
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| subnetID | String | 子网id | subnet-qc90zmk12u | |
| name | String | 名称 | subnet-ldy-openapi-34 | |
| description | String | 描述 | ldy-openapi-test | |
| vpcID | String | vpc id | vpc-w6sty9v8rr | |
| availabilityZones | Array of Strings | 子网所在的可用区名 | ["az1", "az2"] | |
| routeTableID | String | 路由表id | rtb-udnix6dfg2 | |
| networkAclID | String | 子网acl id | ||
| cidr | String | 子网网段 | 172.16.14.0/24 | |
| gatewayIP | String | 网关ip | 172.16.14.1 | |
| start | String | 子网网段起始IP | 172.16.14.3 | |
| end | String | 子网网段结束IP | 172.16.14.253 | |
| availableIPCount | Integer | 子网内可用ipv4数目 | 251 | |
| ipv6CIDR | String | ipv6子网列表 | 100:1:1f2:7206::/64 | |
| ipv6Start | String | 子网内可用的起始IPv6地址 | 100:1:1f2:7206::4 | |
| ipv6End | String | 子网内可用的结束IPv6地址 | 100:1:1f2:7206:ffff:ffff:ffff:fffd | |
| ipv6GatewayIP | String | ipv6网关ip | fe80::f816:3eff:fe43:dcba | |
| dnsList | Array of Strings | DNS服务器地址 | ["8.8.4.4","114.114.114.114"] | |
| ntpList | Array of Strings | NTP服务器地址 | ||
| type | Integer | 子网类型 0 普通子网 1 裸金属子网 | 0 | |
| createdAt | String | 创建时间 | 2022-10-08T04:09:40Z | |
| updatedAt | String | 更新时间 | 2022-10-08T05:09:40Z |
枚举参数
无
请求示例
请求url
https://{host}/v1/applicationAccessPointManage/listSubnet
请求头header
{
"regionId": "200000001852"
}
请求体body
{
"epId": "0",
"vpcId": "vpc-6xacqi7n28"
}
响应示例
{
"statusCode": "200",
"message": "获取子网列表成功",
"returnObj": {
"list": [{
"subnetId": "subnet-fqysb91h75",
"ntpList": [],
"start": "192.168.0.1",
"description": "",
"availabilityZones": [],
"gatewayIp": "192.168.0.1",
"type": 0,
"ipv6Cidr": "240e:981:9314:9400::/64",
"ipv6End": "240e:981:9314:9400:ffff:ffff:ffff:fffd",
"ipv6GatewayIp": "fe80::f816:3eff:feb8:5bf8",
"routeTableId": "rtb-zw0u23qr2b",
"name": "subnet-kms",
"availableIpCount": 224,
"cidr": "192.168.0.0/24",
"end": "192.168.0.254",
"ipv6Start": "240e:981:9314:9400::1",
"dnsList": ["100.95.0.1"],
"networkAclId": "vpc-6xacqi7n28"
}]
}
}
状态码
请参考 状态码
错误码
请参考 错误码
