功能介绍
创建子网。
调试
您可以在API Explorer中调试该接口。
约束与限制
- 网络下存在IPv4子网的情况下，才可以创建IPv6子网。
- VXLAN类型网络下只能有一个IPv4的子网和一个IPv6的子网。
请求参数
|
名称 |
是否必选 |
参数类型 |
说明 |
|---|---|---|---|
|
name |
是 |
String |
|
|
description |
否 |
String |
|
|
cidr |
是 |
String |
|
|
gateway_ip |
是 |
String |
|
|
ipv6_enable |
否 |
Boolean |
|
|
dhcp_enable |
否 |
Boolean |
|
|
primary_dns |
否 |
String |
内网 DNS地址 请参见华为云提供的内网DNS地址是多少？ 可以通过查询名称服务器列表查看DNS服务器的地址。 |
|
secondary_dns |
否 |
String |
内网DNS地址请参见华为云提供的内网DNS地址是多少？ 可以通过查询名称服务器列表查看DNS服务器的地址。 |
|
dnsList |
否 |
Array of strings |
内网DNS地址请参见华为云提供的内网DNS地址是多少？ 可以通过查询名称服务器列表查看DNS服务器的地址。 |
|
availability_zone |
否 |
String |
|
|
vpc_id |
是 |
String |
子网所在VPC标识 |
|
extra_dhcp_opts |
否 |
||
|
tags |
否 |
Array of Strings |
|
请求示例
- 创建一个子网，所在vpc的id为3ec3b33f-ac1c-4630-ad1c-7dba1ed79d85，命名为subent，设置cidr为192.168.20.0/24，网关IP为192.168.20.1。
POST https://{Endpoint}/v1/{project_id}/subnets { "subnet": { "name": "subnet", "description": "", "cidr": "192.168.20.0/24", "gateway_ip": "192.168.20.1", "ipv6_enable": true, "dhcp_enable": true, "primary_dns": "114.xx.xx.114", "secondary_dns": "114.xx.xx.115", "dnsList": [ "114.xx.xx.114", "114.xx.xx.115" ], "availability_zone": "aa-bb-cc", "vpc_id": "3ec3b33f-ac1c-4630-ad1c-7dba1ed79d85", "extra_dhcp_opts": [ { "opt_value": "10.100.0.33,10.100.0.34", "opt_name": "ntp" }, { "opt_value": "24h", "opt_name": "addresstime" } ] } }
响应参数
|
名称 |
参数类型 |
说明 |
|---|---|---|
|
id |
String |
uuid形式的一个资源标识 |
|
name |
String |
|
|
description |
String |
|
|
cidr |
String |
|
|
gateway_ip |
String |
|
|
ipv6_enable |
Boolean |
是否创建IPv6子网 |
|
cidr_v6 |
String |
IPv6子网的网段，如果子网为IPv4子网，则不返回此参数 |
|
gateway_ip_v6 |
String |
IPv6子网的网关，如果子网为IPv4子网，则不返回此参数 |
|
dhcp_enable |
Boolean |
子网是否开启dhcp功能 |
|
primary_dns |
String |
|
|
secondary_dns |
String |
|
|
dnsList |
Array of strings |
|
|
availability_zone |
String |
|
|
vpc_id |
String |
子网所在VPC标识 |
|
status |
String |
|
|
neutron_network_id |
String |
对应网络（OpenStack Neutron接口）id |
|
neutron_subnet_id |
String |
对应子网（OpenStack Neutron接口）id |
|
neutron_subnet_id_v6 |
String |
对应IPv6子网（OpenStack Neutron接口）id，如果子网为IPv4子网，则不返回此参数 |
|
extra_dhcp_opts |
||
|
scope |
String |
子网作用域。 取值范围：
|
|
tenant_id |
String |
功能说明：项目ID。 |
|
created_at |
String |
|
|
updated_at |
String |
|
响应示例
{
"subnet": {
"id": "4779ab1c-7c1a-44b1-a02e-93dfc361b32d",
"name": "subnet",
"description": "",
"cidr": "192.168.20.0/24",
"dnsList": [
"114.xx.xx.114",
"114.xx.xx.115"
],
"status": "UNKNOWN",
"vpc_id": "3ec3b33f-ac1c-4630-ad1c-7dba1ed79d85",
"gateway_ip": "192.168.20.1",
"ipv6_enable": true,
"cidr_v6": "2001:db8:a583::/64",
"gateway_ip_v6": "2001:db8:a583::1",
"dhcp_enable": true,
"primary_dns": "114.xx.xx.114",
"secondary_dns": "114.xx.xx.115",
"availability_zone": "aa-bb-cc",
"neutron_network_id": "4779ab1c-7c1a-44b1-a02e-93dfc361b32d",
"neutron_subnet_id": "213cb9d-3122-2ac1-1a29-91ffc1231a12",
"neutron_subnet_id_v6": "e0fa7de1-a6e2-44c9-b052-b9d8cebe93c4",
"extra_dhcp_opts": [
{
"opt_value": "10.100.0.33,10.100.0.34",
"opt_name": "ntp"
},
{
"opt_value": "24h",
"opt_name": "addresstime"
}
],
"tenant_id": "087679f0aa80d32a2f4ec0172f5e902b",
"created_at": "2022-12-15T02:42:07",
"updated_at": "2022-12-15T02:42:07"
}
}
状态码
请参见状态码。
错误码
请参考错误码。
