为VPC添加附加网段。
接口说明
-
一个 VPC 最多支持添加的附加网段个数如下：
一个 VPC 最多支持添加 5 个附加 IPv4 网段。
一个 VPC 最多支持添加 5 个附加 IPv6 网段。
-
AssociateVpcCidrBlock 接口不支持并发为同一个 VPC 添加附加网段。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
vpc:AssociateVpcCidrBlock |
create |
*VPC
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| RegionId |
string |
是 |
需要添加附加网段的 VPC 所在地域 ID。 您可以通过调用 DescribeRegions 接口获取地域 ID。 |
ch-hangzhou |
| VpcId |
string |
是 |
需要添加附加网段的 VPC 的 ID。 |
vpc-o6wrloqsdqc9io3mg**** |
| SecondaryCidrBlock |
string |
否 |
需要添加的附加 IPv4 网段，网段要求如下：
配置限制如下：
说明
不通过 IPAM 地址池为 VPC 添加附加网段时，参数 SecondaryCidrBlock 和参数 Ipv6CidrBlock 必须输入一个且不能都输入。 |
192.168.0.0/16 |
| SecondaryCidrMask |
integer |
否 |
通过输入掩码的方式从 IPAM 地址池为 VPC 添加附加 IPv4 网段。 说明
指定 IPAM 地址池为 VPC 添加附加 IPv4 网段时，参数 SecondaryCidrBlock 或 SecondaryCidrMask 至少输入一个。 |
16 |
| IPv6CidrBlock |
string |
否 |
VPC 的指定 IPv6 网段。 说明
参数 SecondaryCidrBlock 和参数 Ipv6CidrBlock 不能都输入。 |
2408:XXXX:0:6a::/56 |
| Ipv6Isp |
string |
否 |
VPC 的 IPv6 地址段类型，取值：
说明
如果是开通了单线带宽白名单的用户，该字段可以设置为 ChinaTelecom（中国电信）、ChinaUnicom（中国联通）和 ChinaMobile（中国移动）。 |
BGP |
| IpVersion |
string |
否 |
IP 地址的版本类型。取值：
|
IPV4 |
| IpamPoolId |
string |
否 |
IPAM 地址池实例 ID。 |
ipam-pool-sycmt3p2a9v63i**** |
| Ipv6CidrMask |
integer |
否 |
通过输入掩码的方式从 IPAM 地址池为 VPC 添加 IPv6 网段。 说明
指定 IPAM 地址池为 VPC 添加附加 IPv6 网段时，参数 IPv6CidrBlock 或 Ipv6CidrMask 至少输入一个。 |
56 |
| RegionId |
string |
是 |
需要添加附加网段的 VPC 所在地域 ID。 您可以通过调用 DescribeRegions 接口获取地域 ID。 |
ch-hangzhou |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
请求 ID。 |
||
| RequestId |
string |
请求 ID。 |
C1221A1F-2ACD-4592-8F27-474E02883159 |
| CidrBlock |
string |
为 VPC 添加的附加网段。 |
192.168.0.0/16 |
| IpVersion |
string |
附加网段的 IP 地址类型。 |
IPV4 |
示例
正常返回示例
JSON格式
{
"RequestId": "C1221A1F-2ACD-4592-8F27-474E02883159",
"CidrBlock": "192.168.0.0/16",
"IpVersion": "IPV4"
}错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | InvalidVpc.NotFound | %s | |
| 400 | IncorrectStatus.Vpc | %s | |
| 400 | ParamExclusive.SecondaryCidrAndIpv6Cidr | %s | |
| 400 | OperationUnsupported.VpcMultiCidr | %s | |
| 400 | MissingParam.SecondaryCidrOrIpv6Cidr | %s | |
| 400 | OperationUnsupported.IPv6ULA | %s | |
| 400 | OperationFailed.Ipv6CidrBlockExisted | %s | |
| 400 | InvalidIpv6ULACidrBlock.Malformed | %s | |
| 400 | QuotaExceeded.GUAIpv6CidrBlock | %s | |
| 400 | IllegalParam.Ipv6CidrType | %s | |
| 400 | OperationUnsupported.OnlyULA | %s | |
| 400 | InvalidCidrBlock.Malformed | Specified CIDR block is not valid. | |
| 400 | IllegalParam.SecondaryCidrBlock | %s | |
| 400 | Duplicated.SecondaryCidrBlock | %s | |
| 400 | OperationFailed.ConflictWithEntry | %s | |
| 400 | QuotaExceeded.VpcMultiCidr | %s | |
| 400 | MissingParam.SecondaryCidrBlockOrIpv6CidrBlock | Either SecondaryCidrBlock or Ipv6CidrBlock must be specified. | 缺少必填参数附加网段或者IPv6网段。 |
| 400 | MissingParam.VpcId | You must specify VpcId. | 缺少必填参数VpcId。 |
| 400 | UnsupportedFeature.Ipv6Isp | The Ipv6Isp feature is not supported. | 指定的Ipv6Isp特性不支持。 |
| 400 | IllegalParam.IpVersion | %s | |
| 400 | OperationDenied.GUAIpv6CidrBlock | The operation is not allowed because this ipv6 CIDR is not reserved. | |
| 400 | OperationFailed.IPv6CidrNotReserved | Operation failed because this ipv6 cidr is not reserved. | |
| 400 | InvalidCidrBlock | Specified CIDR block is already exists. | |
| 400 | IllegalParam.IpamPool | The specified IPAM pool cannot be empty. | IPAM Pool不可以为空。 |
| 400 | MissingParam.SecondaryCidrMask | The parameter SecondaryCidrMask must be input. | SecondaryCidrMask参数需要输入。 |
| 400 | IllegalParam.SecondaryCidrMask | The specified Secondary CIDR Mask is illegal. | 指定的SecondaryCidrMask不合法。 |
| 400 | OperationDenied.RequestRegionInvalid | The operation is not allowed because the request is not invoked in the region of the IPAM pool. | 操作被拒绝，因为未在地址池所在地域调用请求。 |
| 400 | OperationDenied.IpamPoolNotInRegion | The operation is not allowed because the IPAM pool not in specific region does not support creating VPC or associating CIDR for VPC. | 操作被拒绝，因为无法从不具备地域属性的地址池中创建VPC或为VPC添加附加网段。 |
| 400 | MissingParam.CidrOrCidrMask | The CIDR or CIDR Mask must be input. | 从IPAM地址池创建资源时，请输入Cidr或CidrMask。 |
| 400 | OperationDenied.CidrInExcludeCidrs | The operation is not allowed because the input CIDR is within the illegal CIDRs. | 操作被拒绝，原因是输入的CIDR在不合法的CIDR范围内。 |
| 400 | OperationDenied.AvailableCidrInsufficient | The operation is not allowed because available CIDR is insufficient. | 操作被拒绝，原因是可用的CIDR资源不足。 |
| 400 | UnsupportedFeature.Ipam | IPAM is not supported in this region. | 该地域不支持IPAM功能。 |
| 400 | UnsupportedFeature.VpcIpamIpv6 | The specified IPAM pool does not support the IPv6 feature. | 指定的IPAM地址池不支持IPv6功能。 |
| 400 | OperationDenied.CidrUnavailableInPool | The operation is not allowed because the CIDR is unavailable in the IPAM pool. | 操作被拒绝，原因是CIDR在IPAM地址池中不可用。 |
| 400 | InvalidIpv6CidrBlock.Malformed | Param Ipv6CidrBlock is malformed. | 参数IPv6 网段不合法 |
| 400 | MissingParam.IpVersion | The parameter IpVersion is missing. | 参数IpVersion缺失。 |
| 400 | Mismatch.IpVersionAndIpamPoolIpVersion | The input IpVersion is inconsistent with the IpVersion of the input IPAM pool. | 输入的IpVersion和输入的地址池的IpVersion不一致。 |
| 400 | IllegalParam.Ipv6CidrBlock | The parameter of Ipv6CidrBlock is illegal. | 参数Ipv6CidrBlock非法。 |
| 400 | OperationFailed.Ipv6CidrBlockOverLapped | The input IPv6 CIDR block overlaps with the existing ones. | 输入的IPv6网段和现有的网段重叠。 |
| 400 | QuotaExceeded.IPv6CidrBlock | The number of IPv6 CIDR blocks in the VPC exceeds the limit. | VPC中的IPv6网段数超过了限制。 |
| 400 | OperationDenied.MaskOfCidrIsNotAllowed | The input mask or mask of the input CIDR is not allowed. | 输入的掩码或CIDR的掩码不在允许的范围内。 |
| 400 | IllegalParam.Ipv6Isp | The specified Ipv6Isp is illegal. | 指定的Ipv6Isp参数不合法。 |
| 400 | IllegalParam.CidrMask | The input CIDR mask is illegal. | 指定的网段掩码不合法。 |
| 500 | OperationFailed.ResourceNotEnough | Insufficient resources. | 您申请的资源不足，如仍需申请，请提工单处理 |
| 403 | Forbbiden | User not authorized to operate on the specified resource. | 用户没有权限操作指定的资源。 |
| 404 | ResourceNotFound.IpamPool | The dependent IPAM pool is not found. | 依赖资源IPAM Pool不存在。 |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。