文档首页/ 虚拟私有云 VPC/ API参考（吉隆坡区域）/ API/ 子网/ 更新子网
更新时间：2024-04-18 GMT+08:00
查看PDF

更新子网

功能介绍

更新子网。

URI

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

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

名称

是否必选

说明

project_id

是

项目ID，获取项目ID请参见获取项目ID。

vpc_id

是

子网对应的vpc_id。

subnet_id

是

子网唯一标识。

如果您使用管理控制台，此值即为子网详情中的“网络ID”参数值。

请求参数

表2 请求参数

名称

是否必选

参数类型

说明

subnet

是

subnet object

subnet对象。
表3 subnet对象

名称

是否必选

参数类型

说明

name

是

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

description

否

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

ipv6_enable

否

Boolean
  • 功能说明：是否开启IPv6功能。
  • 取值范围：true（开启），false（关闭）。

dhcp_enable

否

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

primary_dns

否

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

secondary_dns

否

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

    secondary_dns的值不能与primary_dns值相同。

    只有一个dns服务器地址时，只显示primary_dns，不显示secondary_dns。

dnsList

否

Array of strings
  • 功能说明：子网dns服务器地址的集合；如果想使用两个以上dns服务器，请使用该字段。
  • 约束：是子网dns服务器地址1跟子网dns服务器地址2的合集的父集

请求示例

  • 更新id为4779ab1c-7c1a-44b1-a02e-93dfc361b32d的子网，名称更新为subnet02，更新dns和dhcp。 
    PUT https://{Endpoint}/v1/{project_id}/vpcs/{vpc_id}/subnets/4779ab1c-7c1a-44b1-a02e-93dfc361b32d

{
    "subnet": {
        "name": "subnet02",
        "ipv6_enable": true,
        "dhcp_enable": false,
        "primary_dns": "114.xx.xx.115",
        "secondary_dns": "114.xx.xx.116"
    }
}

响应参数

表4 响应参数

名称

参数类型

说明

subnet

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"
    }
}

状态码

请参见状态码。

错误码

请参考错误码。

父主题： 子网