# 创建子网 #### 功能介绍 创建子网。 #### 调试 您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=VPC&version=v2&api=NeutronCreateSubnet)中调试该接口。 #### 约束与限制 - 网络下存在IPv4子网的情况下，才可以创建IPv6子网。 - VXLAN类型网络下只能有一个IPv4的子网和一个IPv6的子网。 #### URI POST /v2.0/subnets #### 请求参数 表1请求参数 | 参数名称 | 类型 | 必选 | 说明 | |:---|:---|:---|:---| | subnet | [subnet] object | 是 | subnet对象，参见[表2]。 | 表2subnet对象 | 参数名称 | 是否必选 | 类型 | 说明 | |:---|:---|:---|:---| | name | 否 | String | 子网的名称 | | ip_version | 否 | Integer | IP版本 【使用说明】支持4（IPv4）、6（IPv6） | | ipv6_address_mode | 否 | String | IPv6寻址模式 【使用说明】仅支持dhcpv6-stateful | | ipv6_ra_mode | 否 | String | IPv6路由广播模式 【使用说明】仅支持dhcpv6-stateful | | network_id | 是 | String | 所属网络的id | | cidr | 是 | String | CIDR格式 【使用说明】IPV4只支持10.0.0.0/8,172.16.0.0/12,192.168.0.0/16三个网段内的地址，掩码长度不能大于28。 约束:当ip_version=6时,该字段不支持设置 | | gateway_ip | 否 | String | 网关IP不允许和allocation_pools地址块冲突。 【使用说明】不支持修改。 | | allocation_pools | 否 | Array of [allocation_pool] objects | 可用的IP池，allocation_pool对象参见[表3] 例如：\[ { "start": "10.0.0.2", "end": "10.0.0.251"} \] 每个子网的第1个和最后3个IP地址为系统保留地址。以192.168.1.0/24为例，192.168.1.0、 192.168.1.253、192.168.1.254和192.168.1.255这些地址是系统保留地址。 \[{"start": "2001:db8:a583:9::2", "end": "2001:db8:a583:9:ffff:ffff:ffff:fffc"}\] ipv6子网以2001:db8:a583:9::/64为例，2001:db8:a583:9::1和2001:db8:a583:9:ffff:ffff:ffff:fffd、2001:db8:a583:9:ffff:ffff:ffff:fffe、2001:db8:a583:9:ffff:ffff:ffff:ffff这些地址是系统保留地址。 系统预留地址默认不在allocation_pool范围内。 约束：更新时allocation_pool范围不能包含网关和广播地址的所有IP。 | | dns_nameservers | 否 | Array of strings | dns服务器 【使用说明】 例如："dns_nameservers": \["8.xx.xx.8","8.xx.xx.4"\] 最大为5个 不填时，默认为空 内网DNS地址请参见[华为云提供的内网DNS地址是多少？](https://support.huaweicloud.com/dns_faq/dns_faq_002.html) | | host_routes | 否 | Array of [host_route] objects | 虚拟机静态路由，参见[表4] 【使用说明】不支持，忽略输入信息 | | enable_dhcp | 否 | Boolean | 是否启动dhcp，false表示不提供dhcp服务的能力 【使用说明】只支持true | 表3allocation_pool对象 | 参数名 | 是否必选 | 参数类型 | 说明 | |:---|:---|:---|:---| | start | 否 | String | 网络池起始IP | | end | 否 | String | 网络池结束IP | 表4host_route对象 | 参数名 | 是否必选 | 参数类型 | 说明 | |:---|:---|:---|:---| | destination | 否 | String | 路由目的子网 | | nexthop | 否 | String | 路由下一跳IP | #### 请求示例 创建IPv4子网，所在network为0133cd73-34d4-4d4c-bf1f-e65b24603206，指定cidr为172.16.2.0/24，命名为subnet-test。 ``` POST https://{Endpoint}/v2.0/subnets { "subnet": { "name": "subnet-test", "network_id": "0133cd73-34d4-4d4c-bf1f-e65b24603206", "cidr": "172.16.2.0/24", "enable_dhcp": true } } ``` #### 响应参数 表5响应参数 | 参数名称 | 类型 | 说明 | |:---|:---|:---| | subnet | [subnet] object | subnet对象，参见[表6]。 | 表6subnet对象 | 参数名称 | 类型 | 说明 | |:---|:---|:---| | id | String | 子网的id 【使用说明】在查询子网列表时非必选 | | name | String | 子网的名称 | | ip_version | Integer | IP版本 【使用说明】支持4（IPv4）、6（IPv6） | | ipv6_address_mode | String | IPv6寻址模式 【使用说明】仅支持dhcpv6-stateful | | ipv6_ra_mode | String | IPv6路由广播模式 【使用说明】仅支持dhcpv6-stateful | | network_id | String | 所属网络的id | | cidr | String | CIDR格式 【使用说明】IPV4只支持10.0.0.0/8,172.16.0.0/12,192.168.0.0/16三个网段内的地址，掩码长度不能大于28。 约束:当ip_version=6时,该字段不支持设置 | | gateway_ip | String | 网关IP不允许和allocation_pools地址块冲突。 【使用说明】不支持修改。 | | allocation_pools | Array of [allocation_pool] objects | 可用的IP池，allocation_pool对象参见 [表7] 例如：\[ { "start": "10.0.0.2", "end": "10.0.0.251"} \] 每个子网的第1个和最后3个IP地址为系统保留地址。以192.168.1.0/24为例，192.168.1.0、 192.168.1.253、192.168.1.254和192.168.1.255这些地址是系统保留地址。系统预留地址默认不在allocation_pool范围内。 \[{"start": "2001:db8:a583:9::2", "end": "2001:db8:a583:9:ffff:ffff:ffff:fffc"}\] ipv6子网以2001:db8:a583:9::/64为例，2001:db8:a583:9::1和2001:db8:a583:9:ffff:ffff:ffff:fffd、2001:db8:a583:9:ffff:ffff:ffff:fffe、2001:db8:a583:9:ffff:ffff:ffff:ffff这些地址是系统保留地址。 约束：更新时allocation_pool范围不能包含网关和广播地址的所有IP。 | | dns_nameservers | Array of strings | dns服务器 例如："dns_nameservers": \["8.xx.xx.8","8.xx.xx.4"\] | | host_routes | Array of [host_route] objects | 虚拟机静态路由，参见[表8] 【使用说明】不支持，忽略输入信息 | | tenant_id | String | 项目ID | | enable_dhcp | Boolean | 是否启动dhcp，false表示不提供dhcp服务的能力 【使用说明】只支持true | | subnetpool_id | String | 子网池id 【使用说明】目前IPv4不支持，IPv6支持 | | project_id | String | 项目ID，请参见[获取项目ID](https://support.huaweicloud.com/api-vpc/vpc_api_0011.html)。 | | created_at | String | 资源创建时间，UTC时间 格式：yyyy-MM-ddTHH:mm:ss | | updated_at | String | 资源更新时间，UTC时间 格式：yyyy-MM-ddTHH:mm:ss | 表7allocation_pool对象 | 参数名 | 参数类型 | 备注 | |:---|:---|:---| | start | String | 网络池起始IP | | end | String | 网络池结束IP | 表8host_route对象 | 参数名 | 参数类型 | 备注 | |:---|:---|:---| | destination | String | 路由目的子网 | | nexthop | String | 路由下一跳IP | #### 响应示例 ``` { "subnet": { "name": "subnet-test", "cidr": "172.16.2.0/24", "id": "98bac90c-0ba7-4a63-8995-097da9bead1c", "enable_dhcp": true, "network_id": "0133cd73-34d4-4d4c-bf1f-e65b24603206", "tenant_id": "bbfe8c41dd034a07bebd592bf03b4b0c", "project_id": "bbfe8c41dd034a07bebd592bf03b4b0c", "dns_nameservers": [], "allocation_pools": [ { "start": "172.16.2.2", "end": "172.16.2.251" } ], "host_routes": [], "ip_version": 4, "gateway_ip": "172.16.2.1", "created_at": "2018-09-20T02:02:16", "updated_at": "2018-09-20T02:02:16" } } ``` #### 状态码 请参见[状态码](https://support.huaweicloud.com/api-vpc/vpc_api_0002.html)。 #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-vpc/vpc_api_0003.html)。