文档中心 API中心网络管理创建网络

创建网络

功能介绍

在用户项目下创建一个新网络。

Endpoint

home.jcloud.sjtu.edu.cn:9696

URI

POST /v2.0/networks

请求消息

请求参数

参数名称	类型	必选	说明
network	Object	是	network对象列表，参见表1。

表1 network对象

参数	是否必选	参数类型	描述
admin_state_up	否	Boolean	网络的管理状态，为up (true)或down (false)。
name	否	String	网络名称
port_security_enabled	否	Boolean	网络中端口的安全状态。有效值为enabled (true)和disabled (false)
provider:network_type	否	String	该网络应该映射到的物理网络类型
description	否	String	网络描述。

响应消息

响应参数

参数名称	类型	说明
network	Object	network对象列表，参见表2。

表2 network对象

参数	类型	说明
ipv6_address_scope	String	网络关联的IPv6地址范围ID。
revision_number	Integer	资源的修订号
port_security_enabled	Boolean	网络中端口的安全状态。有效值为enabled (true)和disabled (false)。该值作为新创建端口的port_security_enabled字段的默认值
id	String	网络的ID
router:external	Boolean	标识该网络是否有一个关联的外部路由
availability_zone_hints	Array	网络可用域选项
availability_zones	Array	网络可用域
ipv4_address_scope	String	网络关联的IPv4地址范围ID
shared	Boolean	指示该网络是否为共享网络
project_id	String	项目ID
status	String	网络状态。值为`ACTIVE`, `DOWN`, `BUILD` 或者 `ERROR`.
subnets	Array of strings	关联的子网。
description	String	描述信息
tags	String	资源上的标签列表
updated_at	String	资源更新时间
name	String	网络名称
qos_policy_id	String	与网络关联的QoS策略ID
admin_state_up	Boolean	网络的管理状态，为up (true)或down (false)
tenant_id	String	项目ID
created_at	String	创建时间
mtu	Integer	用于处理分片的最大传输单元(MTU)值。IPv4最小值为68,IPv6最小值为1280。

请求示例

请求URL示例

1	POST https://{endpoint}/v2.0/networks

创建网络示例：指定网络名称和网络管理状态

{
    "network": {
        "name": "network-create-by-api",
        "admin_state_up": true
    }
}

响应示例

{
	"network": {
		"ipv6_address_scope": null,
		"revision_number": 2,
		"port_security_enabled": true,
		"id": "bb6faf53-4123-41ab-a8d0-a17c61037563",
		"router:external": false,
		"availability_zone_hints": [],
		"availability_zones": [],
		"ipv4_address_scope": null,
		"shared": false,
		"project_id": "7a3856dc8df348c1ae22dd58d4197749",
		"status": "ACTIVE",
		"subnets": [],
		"description": "",
		"tags": [],
		"updated_at": "2021-04-07T02:58:45Z",
		"is_default": false,
		"name": "network-create-by-api",
		"qos_policy_id": null,
		"admin_state_up": true,
		"base_network": false,
		"tenant_id": "7a3856dc8df348c1ae22dd58d4197749",
		"created_at": "2021-04-07T02:58:45Z",
		"mtu": 1450
	}
}