ModifyVpcAttributes--私有网络-火山引擎

文档中心

立即注册

导航

ModifyVpcAttributes

最近更新时间：2024.09.06 08:11:09首次发布时间：2021.07.29 14:11:53

调用 ModifyVpcAttributes 接口，修改VPC的信息。

调用说明

以下可选参数如不配置，则保持原有配置。
ModifyVpcAttributes 为异步接口，即返回请求ID时，系统后台仍在配置。您可调用 DescribeVpcAttributes 查看VPC的状态，Pending表示配置中，Available 表示配置完成。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

参数名称	类型	是否必选	示例值	描述
Action	String	是	ModifyVpcAttributes	要执行的操作，取值：ModifyVpcAttributes。
Version	String	是	2020-04-01	API版本信息，取值为：2020-04-01。
VpcId	String	是	vpc-bp15zct37pq72zv****	待修改信息的VPC的ID。您可以调用 DescribeVpcs 接口，查询VPC的ID。
VpcName	String	否	Vpc-1	VPC的名称。长度限制为1 ~ 128个字符。需要以字母、中文或数字开头，可包含点号（.）、下划线（_）和短横线（-）。不能以`http://`或`https://`开头。
Description	String	否	This is my VPC.	VPC的描述信息。长度限制为0~ 255个字符。需要以字母、中文或数字开头。可包含英文逗号（,）、点号（.）、下划线（_）、空格（）、等号（=）、短横线（-）、中文逗号（，）、中文句号（。）。不能以`http://`或`https://`开头。
DnsServers.N	String	否	DnsServers.1=12.XX.XX.5&DnsServers.2=12.XX.XX.6	VPC的DnsServers。参数 - N：表示DNS服务器地址的序号，单次调用数量上限为5个，每个DnsServer必须以合法IP形式给出。多个IP地址之间用&分隔。
EnableIpv6	Boolean	否	true	开启/关闭IPv6功能，取值如下： true：开启。 false：关闭。仅当VPC下所有子网已关闭IPv6且VPC未关联IPv6网关时，可配置此取值。说明 IPv6功能正在邀测中，暂仅支持完成企业认证的账号申请试用，如需试用，请联系客户经理。
Ipv6CidrBlock	String	否	2408:XXXX:0:a600::/56	VPC的IPv6网段。仅参数`EnableIpv6`设置为“true”时，可传入本参数，如果不传入本参数，则由系统自动分配IPv6网段。说明 IPv6功能正在邀测中，暂仅支持完成企业认证的账号申请试用，如需试用，请联系客户经理。

返回数据

参数名称	类型	示例值	描述
RequestId	String	2021062415303301022514515207C4****	请求ID。

请求示例

GET /?Action=ModifyVpcAttributes&Version=2020-04-01&VpcId=vpc-bp15zct37pq72zv****&VpcName=vpc-1 HTTP/1.1
Host: open.volcengineapi.com
Service: vpc
Region: cn-beijing

返回示例

{
    "ResponseMetadata": {
        "RequestId": "2021062415303301022514515207C4****",
        "Action": "ModifyVpcAttributes",
        "Version": "2020-04-01",
        "Service": "vpc",
        "Region": "cn-beijing"
    },
    "Result": {
        "RequestId": "2021062415303301022514515207C4****"
    }
}

错误码

此处仅展示当前API的错误码，更多错误码请参见公共错误码。

HttpCode	错误码	错误信息	描述
400	InvalidCidr.Malformed	The specified cidr block is malformed.	指定的网段格式不合法。
400	InvalidDescription.Malformed	The specified description is malformed. Ensure the maximum length of description is 255.	指定的描述格式不合法。描述长度不能超过255个字符。
400	InvalidDescription.Malformed	The specified description is malformed.	指定的描述格式不合法。请修复描述格式后重试。
400	InvalidEnableIpv6	Repeat enable vpc IPv6.	VPC 已经开启IPv6，不能重复开启。
400	InvalidIpv6CidrBlock.NotReserved	The specified IPv6 CIDR block is not reserved.	指定的 IPv6 地址段未预留。
400	InvalidName.Malformed	The specified name is malformed. Ensure the maximum length of name is 128.	指定的名称格式不合法。名称长度不能超过128个字符。
400	InvalidName.Malformed	The specified name is malformed.	指定的名称格式不合法。请修复名称格式后重试。
400	InvalidParameter.EnableIpv6	The EnableIpv6 parameter is currently not supported.	当前不支持EnableIpv6请求参数。
400	InvalidVpc.InUse	The specified VPC has dependent resource of an IPv6 route entry.	指定的私有网络包含了IPv6的路由，无法变更。
400	InvalidVpc.InUse	The specified VPC has dependent resource of an IPv6-enabled subnet.	指定的私有网络包含开启了IPv6的子网，无法变更。
400	InvalidVpc.InvalidStatus	The specified VPC is not in the correct status for the request.	指定的VPC所处状态无法响应该请求。
400	InvalidVpcDnsServerIpAddress.Malformed	The specified DNS server IP address is malformed.	指定的DNS服务器IP地址格式不合法。
400	LimitExceeded.VpcDnsServerNumber	You've reached the limit on the number of DNS servers that you can add.	已达到可添加的DNS服务器数量上限。
400	QuotaExceeded.SystemRouteEntry	You've reached the limit on the number of system route entries per route table.	已达到可创建系统路由条目的数量上限。
404	InvalidVpc.NotFound	The specified VPC does not exist.	指定的VPC不存在。