更新时间:2022-01-25 GMT+08:00

更新子网

功能介绍

更新子网。

URI

PUT /v1/{project_id}/vpcs/{vpc_id}/subnets/{subnet_id}

参数说明请参见表1
表1 参数说明

名称

是否必选

说明

project_id

项目ID,获取项目ID请参见获取项目ID

vpc_id

子网对应的vpc_id

subnet_id

子网唯一标识

请求消息

  • 请求参数
    表2 请求参数

    名称

    是否必选

    参数类型

    说明

    subnet

    Object

    subnet对象

    表3 subnet对象

    名称

    是否必选

    参数类型

    说明

    name

    String

    • 功能说明:子网名称
    • 取值范围:1-64个字符,支持数字、字母、中文、_(下划线)、-(中划线)、.(点)

    description

    String

    • 功能说明:子网描述
    • 取值范围:0-255个字符,不能包含“<”和“>”。

    dhcp_enable

    Boolean

    • 功能说明:子网是否开启dhcp功能
    • 取值范围:true(开启),false(关闭)
    • 约束:不填时默认为true。当设置为false时,会导致新创建的ECS无法获取IP地址,Cloud-init无法注入账号密码,请谨慎操作。

    primary_dns

    String

    • 功能说明:子网dns服务器地址1
    • 约束:ip格式

    secondary_dns

    String

    • 功能说明:子网dns服务器地址2
    • 约束:ip格式

    dnsList

    Array of strings

    • 功能说明:子网dns服务器地址的集合;如果想使用两个以上dns服务器,请使用该字段。
    • 约束:是子网dns服务器地址1跟子网dns服务器地址2的合集的父集
  • 请求样例
    PUT https://{Endpoint}/v1/{project_id}/vpcs/{vpc_id}/subnets/4779ab1c-7c1a-44b1-a02e-93dfc361b32d
    
    {
        "subnet": {
            "name": "subnetqq",
            "dhcp_enable": false,
            "primary_dns": "114.xx.xx.115",
            "secondary_dns": "114.xx.xx.116"
        }
    }

响应消息

  • 响应参数
    表4 响应参数

    名称

    参数类型

    说明

    subnet

    Object

    subnet对象

    表5 subnet对象

    名称

    参数类型

    说明

    id

    String

    uuid形式的一个资源标识。

    status

    String

    • 功能说明:子网的状态。
    • 取值范围:ACTIVE,UNKNOWN,ERROR
      • ACTIVE表示子网已挂载到VPC上
      • UNKNOWN表示子网还未挂载到VPC上
      • ERROR表示子网状态故障
  • 响应样例
    {
        "subnet": {
            "id": "4779ab1c-7c1a-44b1-a02e-93dfc361b32d",
            "status": "ACTIVE"
        }
    }

状态码

请参见状态码

错误码

请参考错误码