创建网络
功能介绍
创建网络。
URI
POST /v2.0/networks
请求消息
参数名称 |
类型 |
必选 |
说明 |
|---|---|---|---|
network |
Object |
是 |
network对象列表，参见表2。 |
响应消息
参数名称 |
类型 |
说明 |
|---|---|---|
network |
Object |
network对象列表，参见表4。 |
属性 |
类型 |
说明 |
|---|---|---|
status |
String |
网络状态，可以为ACTIVE，BUILD，DOWN或ERROR。 |
subnets |
Array of strings |
网络关联的子网ID列表。 一个network仅支持关联一个 subnet。 |
name |
String |
网络名称。 name不能为admin_external_net。 |
router:external |
Boolean |
扩展属性：是否外部网络 |
admin_state_up |
Boolean |
管理状态。 只支持true。 |
tenant_id |
String |
项目ID |
shared |
Boolean |
是否支持跨租户共享。 |
id |
String |
网络的id 【使用说明】在查询网络列表时候非必选 |
provider:network_type |
String |
扩展属性：网络类型（支持vxlan, geneve）。 租户只能创建geneve类型网络。 |
availability_zone_hints |
Array of strings |
本网络的候选可用域，当前版本不支持可用域调度。 |
availability_zones |
Array of strings |
本网络的可用域。 |
port_security_enabled |
Boolean |
端口安全使能标记，如果不使能，则network下所有虚机的安全组和dhcp防欺骗不生效 |
dns_domain |
String |
默认内网DNS域地址，系统自动生成维护，不支持设置和更新 |
project_id |
String |
项目ID，请参见获取项目ID。 |
created_at |
String |
资源创建时间，UTC时间 格式：yyyy-MM-ddTHH:mm:ss |
updated_at |
String |
资源更新时间，UTC时间 格式：yyyy-MM-ddTHH:mm:ss |
样例
请求样例
POST https://{Endpoint}/v2.0/networks
{
"network": {
"name": "network-test",
"shared": false,
"admin_state_up": true
}
}
响应样例
{
"network": {
"id": "c360322d-5315-45d7-b7d2-481f98c56edb",
"name": "network-test",
"status": "ACTIVE",
"shared": false,
"subnets": [],
"availability_zone_hints": [],
"availability_zones": [
"az2.dc2",
"az5.dc5"
],
"admin_state_up": true,
"tenant_id": "bbfe8c41dd034a07bebd592bf03b4b0c",
"project_id": "bbfe8c41dd034a07bebd592bf03b4b0c",
"provider:network_type": "vxlan",
"router:external": false,
"port_security_enabled": true,
"created_at": "2018-09-20T01:53:18",
"updated_at": "2018-09-20T01:53:20"
}
}
状态码
请参见状态码。
错误码
请参见错误码。
