- 最新动态
- 功能总览
- 产品介绍
- 快速入门
- 用户指南
- 最佳实践
-
API参考
- 使用前必读
- API概览
- 如何调用API
- API
- API V3
- 应用示例
-
权限和授权项
- 策略及授权项说明
- VPC
- 子网
- 端口
- 对等连接
- VPC路由
- 路由表
- 配额
- 私有IP
- 安全组
- 安全组规则
- VPC标签
- 子网标签
- VPC流日志
- 端口(Openstack Neutron API)
- 网络(Openstack Neutron API)
- 子网(Openstack Neutron API)
- 路由器(Openstack Neutron API)
- 网络ACL(Openstack Neutron API)
- 安全组(Openstack Neutron API)
- VPC(API V3)
- 安全组(API V3)
- 安全组规则(API V3)
- IP地址组(API V3)
- 辅助弹性网卡(API V3)
- 流量镜像会话(API V3)
- 流量镜像筛选条件(API V3)
- 流量镜像筛选规则(API V3)
- 网络ACL(API V3)
- 网络ACL标签(API V3)
- 端口(API V3)
- API授权项注意事项
- 常见问题
- 历史API
- 附录
- SDK参考
- 场景代码示例
-
常见问题
- 计费类
- 虚拟私有云与子网类
- 弹性公网IP类
- 对等连接类
- 虚拟IP类
- 带宽类
-
网络连接类
- VPN支持将两个VPC互连吗?
- ECS有多个网卡时,为何无法通过域名访问公网网站及云中的内部域名?
- 同时拥有自定义路由和EIP的ECS访问外网的优先级是什么?
- 本地主机访问使用弹性云服务器搭建的网站出现间歇性中断怎么办?
- 同一个子网下的弹性云服务器只能通过内网IP地址单向通信怎么办?
- 同一个VPC内的两台弹性云服务器无法互通或者出现丢包等现象时,如何排查?
- Cloud-init连接出现问题时,如何排查?
- EIP连接出现问题时,如何排查?
- 二三层通信出现问题时,如何排查?
- 裸机网络出现问题时,如何排查?
- 弹性云服务器IP获取不到时,如何排查?
- VPN及专线网络连接出现问题时,如何排查?
- 外网能访问服务器,但是服务器无法访问外网时,如何排查?
- 配置了IPv6双栈,为什么无法访问IPv6网站?
- 弹性云服务器防火墙配置完成后,为什么网络不通?
- 路由类
- 安全类
- 视频帮助
- 文档下载
- 通用参考
链接复制成功!
创建子网
功能介绍
创建子网。
调试
您可以在API Explorer中调试该接口。
约束与限制
- 网络下存在IPv4子网的情况下,才可以创建IPv6子网。
- VXLAN类型网络下只能有一个IPv4的子网和一个IPv6的子网。
URI
POST /v2.0/subnets
请求参数
属性 |
是否必选 |
类型 |
说明 |
---|---|---|---|
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地址是多少? |
host_routes |
否 |
Array of host_route objects |
虚拟机静态路由,参见表4 【使用说明】不支持,忽略输入信息 |
enable_dhcp |
否 |
Boolean |
是否启动dhcp,false表示不提供dhcp服务的能力 【使用说明】只支持true |
请求示例
创建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 } }
响应参数
属性 |
类型 |
说明 |
---|---|---|
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对象参见 例如:[ { "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。 |
created_at |
String |
资源创建时间,UTC时间 格式:yyyy-MM-ddTHH:mm:ss |
updated_at |
String |
资源更新时间,UTC时间 格式:yyyy-MM-ddTHH:mm:ss |
响应示例
{ "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" } }
状态码
请参见状态码。
错误码
请参见错误码。