备案 控制台 登录 注册
文档中心 > DescribeSubnet
DescribeSubnet

最近更新时间：2021-12-23

请求方法：GET

接口描述：使用DescribeSubnet查询子网列表。

请求参数

Param

名称

类型

是否必选

描述

Action

String

是

要执行的操作。 取值： DescribeSubnets。

RegionId

String

是

VPC所在的地域。
  HB1-BJMY （华北2-北京2） ；
  HD1-SHMY（华东1-上海）

VpcId

String

是

VPC实例Id


返回参数

名称

类型

描述

RequestId

String

请求ID。

Code

String

请求结果编码。

Msg

String

请求结果描述。

Res

Array

子网列表数组

+BindResources


子网下的资源列表

+Name

String

子网名称

+IsCrossZone

Boolean

是否跨可用区

+IpV6Cidr

String

IPv6网段

+IpV6GatewayIp

String

IPv6网关地址

+HasIpV6

Boolean

是否支持IPv6

+DnsNameServers

Array

DNS域名服务器

+IpAssignedCount

Integer

子网内已分配IP数

+Cidr

String

子网网段

+IpTotalCount

Integer

子网内可用IP总数

+GatewayIp

String

网关地址

+AllocationPool

Object

可分配IP地址池

++End

String

可分配IP地址池结束IP

++Start

String

可分配IP地址池起始IP

+Id

String

子网ID


示例

请求示例

GET https://api.unicloud.com/networks/vpc?Action=DescribeSubnet
&RegionId=cn-beijing
&VpcId=vpc-nuuj2b01o42ob  
&公共请求参数

返回示例

JSON格式

{
   "Code": "Network.Success",
   "Msg": "获取子网列表成功",                          
   "Res": [                          
       {                          
           "BindResources": {},                                                    
           "Name": "tt",                                                    
           "DnsNameServers": [                                                    
               "113.207.55.15",                                                    
               "220.194.70.15"                                                    
           ],                                                    
           "IsCrossZone": false,                                                    
           "AzoneId": "cn-beijing-a",                                                    
           "IpAssignedCount": 0,                                                    
           "Cidr": "192.168.25.0/24",                                                    
           "IpTotalCount": 250,                                            
           "GatewayIp": "192.168.25.1",                                          
           "IpV6Cidr": "1A1A:1A1A:1A1A:C/64",                                            
           "IpV6GatewayIp": "1A1A:1A1A:1A1A:C::2",                                            
           "HasIpV6": true,                                                    
           "AllocationPool": {                                                    
               "End": "192.168.25.251",                                                    
               "Start": "192.168.25.2"                                                    
           },                                                    
           "Id": "c11056de43bc43d298ee1307a9c65fc5"                                                    
       },                                                    
       {                              
           "BindResources": {},                                                    
           "Name": "mysubnet",                                                    
           "DnsNameServers": [                                                    
               "113.207.55.15",                                                    
               "220.194.70.15"                                                    
           ],                                                    
           "IsCrossZone": true,                                                    
           "AzoneId": "",                                                    
           "IpAssignedCount": 0,                                                    
           "Cidr": "192.168.26.0/24",                                                    
           "IpTotalCount": 250,                                                    
           "GatewayIp": "192.168.26.1",                                                                              
           "IpV6Cidr": "1A1A:1A1A:1A1A:C/64",                                                                              
           "IpV6GatewayIp": "1A1A:1A1A:1A1A:C::2",                                                                              
           "HasIpV6": true,                                                                              
           "AllocationPool": {                                                                              
               "End": "192.168.26.251",                                                                              
               "Start": "192.168.26.2"                                                        
           },                                                                              
           "Id": "cdcad19665394c19a54fc2bb9bc28d11"                                                                                                        
       }                                                                                                        
   ],                                                                                                        
   "RequestId": "8fbfd4ab-8f7d-4700-b16b-32e788005316"                                                                                                  
}