在这篇文章中：

    创建网络

    功能介绍

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

    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

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

    1
    2
    3
    4
    5
    6
    {
        "network": {
            "name": "network-create-by-api",
            "admin_state_up": true
        }
    }

    响应示例

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    {
    	"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
    	}
    }

    状态码

    请参见状态码。