更新子网UpdateSubnet_子网_虚拟私有云API-华为云

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

华为云11.11 2核1G 2M 云服务器

29元/年

立即注册领万元上云礼券

抽奖赢11111元免单

续费同价 L实例 2核2G 4M

98元/年

热门域名 1元随心购

1元/年

更新子网UpdateSubnet

时间: 2023-09-21 14:17:58

API网关云计算

猜你想看：

实时语音识别云服务器配置 CDN是什么意思视频点播加速什么是云桌面

功能介绍

更新子网。

调试

您可以在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 下一篇：万物互联时代，泛互联网企业为什么需要华为云网站安全解决方案？

功能介绍

调试

URI

请求参数

请求示例

响应参数

响应示例

状态码

错误码

最新文章

更多内容

7*24

备案

专业服务

退订

建议反馈

售前咨询热线