私有网络

私有网络

产品文档

私有网络

帮助中心 > OpenAPI & SDK > 私有网络 > describeSubnets
搜本产品

describeSubnets

描述

查询子网列表

请求方式

GET

请求地址

https://vpc.jdcloud-api.com/v1/regions/{regionId}/subnets/

名称 类型 是否必需 默认值 描述
regionId String True Region ID

请求参数

名称 类型 是否必需 默认值 描述
pageNumber Integer False 1 页码, 默认为1, 取值范围：[1,∞), 页码超过总页数时, 显示最后一页
pageSize Integer False 20 分页大小，默认为20，取值范围：[10,100]
filters Filter[ ] False subnetIds - subnet ID列表，支持多个
subnetNames - subnet名称列表，支持多个
routeTableId - 子网关联路由表Id，支持单个
aclId - 子网关联acl Id，支持单个
vpcId - 子网所属VPC Id，支持单个

Filter

名称 类型 是否必需 默认值 描述
name String True 过滤条件的名称
operator String False 过滤条件的操作符，默认eq
values String[ ] True 过滤条件的值

返回参数

名称 类型 描述
result Result 返回结果
requestId String 请求ID

Result

名称 类型 描述
subnets Subnet[ ] 子网资源信息列表
totalCount Number 总数量

Subnet

名称 类型 描述
subnetId String Subnet的Id
subnetName String 子网名称
vpcId String 子网所属VPC的Id
addressPrefix String 子网网段，vpc内子网网段不能重叠，cidr的取值范围：10.0.0.0/8、172.16.0.0/12和192.168.0.0/16及它们包含的子网，且子网掩码长度为16-28之间，如果VPC含有Cidr，则必须为VPC所在Cidr的子网
availableIpCount Number 子网可用ip数量
description String 子网描述信息
routeTableId String 子网关联的路由表Id
aclId String 子网关联的acl Id
startIp String 子网的起始地址，子网第1个地位为路由器网关保留，第2个地址为dhcp服务保留
endIp String 子网的结束地址，子网第1个地位为路由器网关保留，第2个地址为dhcp服务保留
createdTime String 子网创建时间

返回码

返回码 描述
200 OK
更新时间：2019-11-19 17:38:39
文档反馈 docs feedback