调用 AssociateVpcCidrBlock 接口，为指定VPC添加辅助网段。

使用说明

单个VPC最多可添加的辅助IPv4的CIDR数量为1个。

辅助IPv4的CIDR应与目标私有网络主网段所属大段相同。

例如，目标私有网络的主网段属于192.168.0.0/16～24大段，则辅助CIDR也必须属于该大段，而不能是10.0.0.0/8～24或172.16.0.0/12～24网段。

目标私有网络的主网段已经是最大网络段（例如192.168.0.0/16）时，则不能再添加辅助CIDR。

辅助CIDR不能与目标VPC下的其他CIDR网段重叠。

辅助CIDR添加成功后不可修改。

AssociateVpcCidrBlock 为异步接口，即返回请求ID时，系统后台仍在配置。您可调用 DescribeVpcAttributes 查看VPC的状态，Pending表示配置中，Available 表示配置完成。

调试

API Explorer

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

去调试

请求参数

下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Action String 必选示例值：AssociateVpcCidrBlock

接口名称。当前 API 的名称为AssociateVpcCidrBlock。

Version String 必选示例值：2020-04-01

接口版本。当前 API 的版本为 2020-04-01。

VpcId String 必选示例值：vpc-257gqcdfvx6n****

VPC的ID。

您可以调用 DescribeVpcs 接口，查询VPC的ID。

SecondaryCidrBlock String 可选示例值：172.16.XX.0/24

待添加的VPC的IPv4辅助网段。您可以使用以下网段中与主网段不重叠的子集作为VPC的辅助网段：

192.168.0.0/16～28

10.0.0.0/8～28

172.16.0.0/12～28

说明

辅助网段必须和主网段属于同一大段。

Ipv6Isp String 可选示例值：ChinaMobile

线路类型。取值如下：

BGP：BGP（多线）。

ChinaMobile：中国移动静态单线。

ChinaTelecom：中国电信静态单线。

ChinaUnicom：中国联通静态单线。

ChinaMobile_Value：中国移动惠选型静态单线。

ChinaUnicom_Value：中国联通惠选型静态单线。

ChinaTelecom_Value：中国电信惠选型静态单线。

Ipv6MaskLen Integer 可选示例值：62

掩码长度。

当Ipv6Isp传入BGP时，仅支持传入56；除此之外，本参数支持62-64。

传入参数Ipv6CidrBlock 后，此参数不生效。

参数Ipv6Isp传入非BGP后，参数Ipv6MaskLen和参数Ipv6CidrBlock二者必须传入一个。

Ipv6CidrBlock String 可选示例值：2408:XXXX:0:a600::/56

待添加的VPC的IPv6辅助网段。

传入本参数后，参数Ipv6MaskLen不生效。

参数Ipv6Isp传入非BGP后，参数Ipv6MaskLen和参数Ipv6CidrBlock二者必须传入一个。

Ipv4IpamPoolId String 可选示例值：ipam-bp15zkdt37pq72zv****

IPAM地址池的ID。

返回参数

下方仅列出本接口特有的返回参数。更多信息请参见返回结构。

RequestId String 示例值：2021062415303301022514515207C4****

请求ID。

VpcId String 示例值：vpc-257gqcdfvx6n****

VPC的ID。

SecondaryCidrBlocks String[] 示例值：172.16.1.0/24

VPC的辅助IPv4网段。

Ipv6CidrBlocks Object[] 示例值：-

VPC的IPv6网段信息。

Ipv6CidrBlock String 示例值：2408:XXXX:0:a600::/56

VPC的IPv6网段。

Ipv6Isp String 示例值：ChinaMobile

线路类型。

BGP：BGP（多线）。

ChinaMobile：中国移动静态单线。

ChinaTelecom：中国电信静态单线。

ChinaUnicom：中国联通静态单线。

ChinaMobile_Value：中国移动惠选型静态单线。

ChinaUnicom_Value：中国联通惠选型静态单线。

ChinaTelecom_Value：中国电信惠选型静态单线。

说明

除BGP（多线）外，其余线路类型均仅支持华东2（上海）地域。

请求示例

返回示例

错误码

状态码	错误码	错误信息	说明
400	DryRunOperation	Exception raised to indicate a successfully authorized action when the DryRun flag is set to true.	该请求设置为DryRun操作，操作授权已获得许可，但未被实际执行。
400	InsufficientIpv6Blocks	The specified pool does not contain enough free IPv6 blocks to fulfill your request.	IPv6 池中的 IPv6 地址段资源不足。
400	InvalidCidr.Malformed	The specified cidr block is malformed.	指定的网段格式不合法。
400	InvalidIpamPoolCidrAllocation.Malformed	The specified CIDR in the IPAM pool is unavailable.	指定IPAM地址池分配CIDR地址块不可用。
400	InvalidIpv6CidrBlock.NotReserved	The specified IPv6 CIDR block is not reserved.	指定的 IPv6 地址段未预留。
400	InvalidParameter.EnableIpv6	The EnableIpv6 parameter is currently not supported.	当前不支持EnableIpv6请求参数。
400	InvalidParameter.MaskLength	The IPv6 mask length in this request is invalid.	该请求中的IPv6掩码长度不合法。
400	InvalidParameter.SecondaryCidrAndIpv6Cidr	The param of request are mutually exclusive.	该请求存在互相排斥的参数。
400	InvalidVpc.InvalidStatus	The specified VPC is not in the correct status for the request.	指定的VPC所处状态无法响应该请求。
400	QuotaExceeded.VpcIpv6Cidr	You've reached the limit on the number of IPv6 CIDR blocks per VPC that you can create.	已达到指定VPC的IPv6网段数量上限。
400	QuotaExceeded.VpcSecondaryCidr	You've reached the limit on the number of secondary cidr blocks per VPC.	已达到VPC下辅助网段的数量上限。
403	Forbidden.IpamPoolAllocationResourceDiscovery	The IPAM pool owner cannot discover resources from the specified account.	IPAM地址池所有者无法发现指定账号的资源。
403	Forbidden.Ipv6IspType	You are not authorized to create this type IPv6 CIDR.	无权限创建该ISP类型的IPv6网段。
404	InvalidVpc.NotFound	The specified VPC does not exist.	指定的VPC不存在。
409	InvalidSecondaryCidrBlock.Conflict	The specified secondary CIDR block conflicts with that of another block in your VPC.	指定的辅助CIDR地址块与所属VPC中另一个CIDR地址块冲突。

私有网络