获取VPC子网列表 - ShowSubnets
功能介绍
获取虚拟私有云(VPC)下的子网列表,返回指定VPC下的所有子网信息。
调用方法
请参见如何调用API。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
- 如果使用身份策略授权,当前API调用无需身份策略权限。
URI
GET /v1/{project_id}/sdg/asset/vpc/{vpc_id}/subnet
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
project_id | 是 | String | 项目ID,用于标识具体的项目。 |
vpc_id | 是 | String | VPC ID,用于标识具体的虚拟私有云。 |
请求参数
无
响应参数
状态码:200
参数 | 参数类型 | 描述 |
|---|---|---|
subnet | Subnet object | 单个子网信息,包含子网的基本属性和网络配置。 |
subnets | Array of Subnet objects | 子网信息列表,包含所有符合条件的子网。 |
参数 | 参数类型 | 描述 |
|---|---|---|
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或项目不存在,获取失败。 |
错误码
请参见错误码。

