# 获取VPC子网列表 - ShowSubnets
#### 功能介绍
获取虚拟私有云（VPC）下的子网列表，返回指定VPC下的所有子网信息。
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-dsc/dsc_02_0008.html)。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-dsc/dsc_02_0031.html)。
- 如果使用身份策略授权，当前API调用无需身份策略权限。
 
#### URI
GET /v1/{project_id}/sdg/asset/vpc/{vpc_id}/subnet
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                   |
|:---|:---|:---|:---|
| project_id | 是    | String | 项目ID，用于标识具体的项目。      |
| vpc_id     | 是    | String | VPC ID，用于标识具体的虚拟私有云。 |
   
#### 请求参数
无
#### 响应参数
**状态码：200**
表2响应Body参数 
| 参数      | 参数类型                                                     | 描述                     |
|:---|:---|:---|
| subnet  | [Subnet] object           | 单个子网信息，包含子网的基本属性和网络配置。 |
| subnets | Array of [Subnet] objects | 子网信息列表，包含所有符合条件的子网。    |
   
 表3Subnet 
| 参数                   | 参数类型             | 描述                                             |
|:---|:---|:---|
| availability_zone    | String           | 可用区，表示子网所在的可用区。                                |
| cidr                 | String           | 子网的IPv4地址范围，使用CIDR表示法定义子网的IP地址段。               |
| cidr_v6              | String           | 子网的IPv6地址范围，使用CIDR表示法定义子网的IPv6地址段。             |
| dhcp_enable          | Boolean          | 是否启用DHCP服务，用于指定子网是否支持DHCP自动分配IP地址。             |
| dns_list             | Array of strings | 子网的DNS服务器地址列表，用于指定子网的DNS服务器。                   |
| gateway_ip           | String           | 子网的IPv4默认网关地址，用于指定子网的默认IPv4网关。                 |
| gateway_ip_v6        | String           | 子网的IPv6默认网关地址，用于指定子网的默认IPv6网关。                 |
| id                   | String           | 子网的唯一标识符，用于唯一标识具体的子网。                          |
| ipv6_enable          | Boolean          | 是否启用IPv6支持，用于指定子网是否支持IPv6地址。                   |
| name                 | String           | 子网的名称，用于标识子网的名称。                               |
| network_id           | String           | 网络的唯一标识符，用于唯一标识子网所属的网络。                        |
| neutron_subnet_id    | String           | Neutron子网的唯一标识符，用于唯一标识OpenStack网络中的子网。         |
| neutron_subnet_id_v6 | String           | Neutron子网的IPv6唯一标识符，用于唯一标识OpenStack网络中的IPv6子网。 |
| primary_dns          | String           | 子网的主DNS服务器地址，用于指定子网的主DNS服务器。                   |
| secondary_dns        | String           | 子网的备用DNS服务器地址，用于指定子网的备用DNS服务器。                 |
| status               | String           | 子网的状态，表示子网的当前状态，如'ACTIVE'表示活动状态。               |
| vpc_id               | String           | 虚拟私有云（VPC）的唯一标识符，用于唯一标识子网所属的VPC。               |
   
#### 请求示例
无
#### 响应示例
无
#### 状态码
| 状态码 | 描述                 |
|:---|:---|
| 200 | 获取VPC子网列表成功。       |
| 401 | 未授权访问，请求被拒绝。       |
| 403 | 无权限进行此操作，请求被拒绝。    |
| 404 | 指定的VPC或项目不存在，获取失败。 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-dsc/ErrorCode.html)。