华为云计算 云知识 更新子网UpdateSubnet
更新子网UpdateSubnet

 

功能介绍

更新子网。

调试

您可以在API Explorer中调试该接口。

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格式

内网 DNS地址 请参见华为云提供的内网DNS地址是多少?

可以通过查询名称服务器列表查看DNS服务器的地址。

secondary_dns

String

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

内网DNS地址请参见华为云提供的内网DNS地址是多少?

可以通过查询名称服务器列表查看DNS服务器的地址。

dnsList

Array of strings

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

内网DNS地址请参见华为云提供的内网DNS地址是多少?

可以通过查询名称服务器列表查看DNS服务器的地址。

extra_dhcp_opts

Array of extra_dhcp_opt objects

子网配置的NTP地址或租约时间,详情请参见extra_dhcp_opt对象。

表4 extra_dhcp_opt对象

名称

是否必选

参数类型

说明

opt_value

String

  • 功能说明:子网配置的NTP地址或子网配置的租约到期时间。
  • 约束:

    opt_name配置为“ntp”,则表示是子网ntp地址,目前只支持IPv4地址,每个IP地址以逗号隔开,IP地址个数不能超过4个,不能存在相同地址。该字段为null表示取消该子网NTP的设置,不能为“ ”(空字符串)。

    opt_name配置为“addresstime”,则该值表示是子网租约到期时间,取值格式有两种,取-1,表示无限租约;数字+h,数字范围是1~30000,比如5h,默认值为24h。

opt_name

String

  • 功能说明:子网配置的NTP地址名称或子网配置的租约到期名称。
  • 约束:目前只支持填写字符串“ntp”或“addresstime”。

请求示例

  • 更新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",
            "extra_dhcp_opts": [
                {
                    "opt_value": "10.100.0.33,10.100.0.34",
                    "opt_name": "ntp"
                },
                {
                    "opt_value": "24h",
                    "opt_name": "addresstime"
                }
            ]
        }
    }
    

响应参数

表5 响应参数

名称

参数类型

说明

subnet

subnet object

subnet对象

表6 subnet对象

名称

参数类型

说明

id

String

uuid形式的一个资源标识。

status

String

  • 功能说明:子网的状态。
  • 取值范围:ACTIVE,UNKNOWN,ERROR
    • ACTIVE表示子网已挂载到VPC上
    • UNKNOWN表示子网还未挂载到VPC上
    • ERROR表示子网状态故障

响应示例

{
    "subnet": {
        "id": "4779ab1c-7c1a-44b1-a02e-93dfc361b32d",
        "status": "ACTIVE"
    }
}

状态码

请参见状态码

错误码

请参考错误码

 

上一篇:修改函数版本别名信息UpdateVersionAlias 下一篇:万物互联时代,泛互联网企业为什么需要华为云网站安全解决方案?