在这篇文章中：

    更新网络

    功能介绍

    更新用户项目下已有网络的属性。

    Endpoint

    home.jcloud.sjtu.edu.cn:9696

    URI

    PUT /v2.0/networks/{network_id}

    参数说明

    名称 是否必选 说明
    network_id 是 网络id

    请求消息

    请求参数

    参数名称 类型 必选 说明
    network Object 是 network对象列表，参见表1。更新操作时至少指定一项属性

    表1 network对象

    参数 是否必选 类型 说明
    admin_state_up 否 Boolean 网络的管理状态，为up (true)或down (false)。
    mtu 否 Integer 用于处理分片的最大传输单元(MTU)值。IPv4最小值为68,IPv6最小值为1280。
    name 否 String 网络名称
    port_security_enabled 否 Boolean 网络中端口的安全状态。有效值为enabled (true)和disabled (false)
    description 否 String 网络描述。

    响应消息

    响应参数

    参数名称 类型 说明
    network Object 网络元数据，参见表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 关联的子网。
    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
    PUT https://{endpoint}/v2.0/networks/702fd695-1444-479b-a1d7-41b6ee2cc486

    修改网络示例：修改指定网络的name属性

    1
    2
    3
    4
    5
    {
        "network": {
            "name": "update_network-create-by-api"
        }
    }

    响应示例

    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
    {
    	"network": {
    		"ipv6_address_scope": null,
    		"revision_number": 6,
    		"port_security_enabled": true,
    		"id": "702fd695-1444-479b-a1d7-41b6ee2cc486",
    		"router:external": false,
    		"availability_zone_hints": [],
    		"availability_zones": ["nova"],
    		"ipv4_address_scope": null,
    		"shared": false,
    		"project_id": "7a3856dc8df348c1ae22dd58d4197749",
    		"status": "ACTIVE",
    		"subnets": ["f5ce667d-479a-40c6-81a6-c82ce950bbc3"],
    		"description": "",
    		"tags": [],
    		"updated_at": "2021-04-08T06:35:29Z",
    		"name": "update_network-create-by-api",
    		"qos_policy_id": null,
    		"admin_state_up": true,
    		"base_network": false,
    		"tenant_id": "7a3856dc8df348c1ae22dd58d4197749",
    		"created_at": "2021-04-08T06:11:17Z",
    		"mtu": 1450
    	}
    }

    状态码

    请参见状态码。