AI 助理
备案控制台
官方文档
输入文档关键字查找
首页 专有网络VPC 开发参考 API参考 API目录 专有网络（VPC） AssociateVpcCidrBlock - 为VPC添加附加网段

AssociateVpcCidrBlock - 为VPC添加附加网段

更新时间：
产品详情
我的收藏

为VPC添加附加网段。

接口说明

  • 一个 VPC 最多支持添加的附加网段个数如下：

    • 一个 VPC 最多支持添加 5 个附加 IPv4 网段。
    • 一个 VPC 最多支持添加 5 个附加 IPv6 网段。

  • AssociateVpcCidrBlock 接口不支持并发为同一个 VPC 添加附加网段。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

  • 操作：是指具体的权限点。
  • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
  • 资源类型：是指操作中支持授权的资源类型。具体说明如下：
    • 对于必选的资源类型，用前面加 * 表示。
    • 对于不支持资源级授权的操作，用全部资源表示。
  • 条件关键字：是指云产品自身定义的条件关键字。
  • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
操作访问级别资源类型条件关键字关联操作
vpc:AssociateVpcCidrBlockcreate
*VPC
acs:vpc:{#regionId}:{#accountId}:vpc/{#VpcId}
    无
无

请求参数

名称类型必填描述示例值
RegionIdstring是

需要添加附加网段的 VPC 所在地域 ID。

您可以通过调用 DescribeRegions 接口获取地域 ID。

ch-hangzhou
VpcIdstring是

需要添加附加网段的 VPC 的 ID。

vpc-o6wrloqsdqc9io3mg****
SecondaryCidrBlockstring否

需要添加的附加 IPv4 网段，网段要求如下：

  • 建议您使用 RFC 1918 标准中指定的私有 IPv4 地址作为 VPC 的附加 IPv4 网段，网段掩码推荐使用 16~28 位。例如：10.0.0.0/16、172.16.0.0/16、192.168.0.0/16。
  • 使用除 100.64.0.0/10、224.0.0.0/4、127.0.0.0/8、169.254.0.0/16 及其子网外的自定义地址段作为专有网络的附加 IPv4 网段。

配置限制如下：

  • 不能以 0 开头，网段掩码推荐使用 16~28 位。

  • 附加网段不得与 VPC 主网段及已添加的附加网段重叠。

说明 不通过 IPAM 地址池为 VPC 添加附加网段时，参数 SecondaryCidrBlock 和参数 Ipv6CidrBlock 必须输入一个且不能都输入。
192.168.0.0/16
SecondaryCidrMaskinteger否

通过输入掩码的方式从 IPAM 地址池为 VPC 添加附加 IPv4 网段。

说明 指定 IPAM 地址池为 VPC 添加附加 IPv4 网段时，参数 SecondaryCidrBlock 或 SecondaryCidrMask 至少输入一个。
16
IPv6CidrBlockstring否

VPC 的指定 IPv6 网段。

说明 参数 SecondaryCidrBlock 和参数 Ipv6CidrBlock 不能都输入。
2408:XXXX:0:6a::/56
Ipv6Ispstring否

VPC 的 IPv6 地址段类型，取值：

  • BGP（默认值）：阿里云 BGP IPv6。
  • ChinaMobile：中国移动（单线）。
  • ChinaUnicom：中国联通（单线）。
  • ChinaTelecom：中国电信（单线）。
说明 如果是开通了单线带宽白名单的用户，该字段可以设置为 ChinaTelecom（中国电信）、ChinaUnicom（中国联通）和 ChinaMobile（中国移动）。
BGP
IpVersionstring否

IP 地址的版本类型。取值：

  • IPV4：IPv4 地址。
  • IPV6：IPv6 地址，当 IpVersion 参数输入 IPV6，SecondaryCidrBlock 参数不传值时可以为 VPC 添加附加 IPv6 网段。
IPV4
IpamPoolIdstring否

IPAM 地址池实例 ID。

ipam-pool-sycmt3p2a9v63i****
Ipv6CidrMaskinteger否

通过输入掩码的方式从 IPAM 地址池为 VPC 添加 IPv6 网段。

说明 指定 IPAM 地址池为 VPC 添加附加 IPv6 网段时，参数 IPv6CidrBlock 或 Ipv6CidrMask 至少输入一个。
56

返回参数

名称类型描述示例值
object

请求 ID。

RequestIdstring

请求 ID。

C1221A1F-2ACD-4592-8F27-474E02883159
CidrBlockstring

为 VPC 添加的附加网段。

192.168.0.0/16
IpVersionstring

附加网段的 IP 地址类型。

IPV4

示例

正常返回示例

JSON格式

{
  "RequestId": "C1221A1F-2ACD-4592-8F27-474E02883159",
  "CidrBlock": "192.168.0.0/16",
  "IpVersion": "IPV4"
}

错误码

HTTP status code错误码错误信息描述
400InvalidVpc.NotFound%s-
400IncorrectStatus.Vpc%s-
400ParamExclusive.SecondaryCidrAndIpv6Cidr%s-
400OperationUnsupported.VpcMultiCidr%s-
400MissingParam.SecondaryCidrOrIpv6Cidr%s-
400OperationUnsupported.IPv6ULA%s-
400OperationFailed.Ipv6CidrBlockExisted%s-
400InvalidIpv6ULACidrBlock.Malformed%s-
400QuotaExceeded.GUAIpv6CidrBlock%s-
400IllegalParam.Ipv6CidrType%s-
400OperationUnsupported.OnlyULA%s-
400InvalidCidrBlock.MalformedSpecified CIDR block is not valid.该CIDR格式不正确。
400IllegalParam.SecondaryCidrBlock%s-
400Duplicated.SecondaryCidrBlock%s-
400OperationFailed.ConflictWithEntry%s-
400QuotaExceeded.VpcMultiCidr%s-
400MissingParam.SecondaryCidrBlockOrIpv6CidrBlockEither SecondaryCidrBlock or Ipv6CidrBlock must be specified.缺少必填参数附加网段或者IPv6网段。
400MissingParam.VpcIdYou must specify VpcId.缺少必填参数VpcId。
400UnsupportedFeature.Ipv6IspThe Ipv6Isp feature is not supported.指定的Ipv6Isp特性不支持。
400IllegalParam.IpVersion%s-
400OperationDenied.GUAIpv6CidrBlockThe operation is not allowed because this ipv6 CIDR is not reserved.-
400OperationFailed.IPv6CidrNotReservedOperation failed because this ipv6 cidr is not reserved.-
400InvalidCidrBlockSpecified CIDR block is already exists.该交换机网段与其他交换机的网段重叠或与已有的自定义路由的目标网段重叠，请使用其他未被占用的网段。
400IllegalParam.IpamPoolThe specified IPAM pool cannot be empty.IPAM Pool不可以为空。
400MissingParam.SecondaryCidrMaskThe parameter SecondaryCidrMask must be input.SecondaryCidrMask参数需要输入。
400IllegalParam.SecondaryCidrMaskThe specified Secondary CIDR Mask is illegal.指定的SecondaryCidrMask不合法。
400OperationDenied.RequestRegionInvalidThe operation is not allowed because the request is not invoked in the region of the IPAM pool.操作被拒绝，因为未在地址池所在地域调用请求。
400OperationDenied.IpamPoolNotInRegionThe operation is not allowed because the IPAM pool not in specific region does not support creating VPC or associating CIDR for VPC.操作被拒绝，因为无法从不具备地域属性的地址池中创建VPC或为VPC添加附加网段。
400MissingParam.CidrOrCidrMaskThe CIDR or CIDR Mask must be input.从IPAM地址池创建资源时，请输入Cidr或CidrMask。
400OperationDenied.CidrInExcludeCidrsThe operation is not allowed because the input CIDR is within the illegal CIDRs.操作被拒绝，原因是输入的CIDR在不合法的CIDR范围内。
400OperationDenied.AvailableCidrInsufficientThe operation is not allowed because available CIDR is insufficient.操作被拒绝，原因是可用的CIDR资源不足。
400UnsupportedFeature.IpamIPAM is not supported in this region.该地域不支持IPAM功能。
400UnsupportedFeature.VpcIpamIpv6The specified IPAM pool does not support the IPv6 feature.指定的IPAM地址池不支持IPv6功能。
400OperationDenied.CidrUnavailableInPoolThe operation is not allowed because the CIDR is unavailable in the IPAM pool.操作被拒绝，原因是CIDR在IPAM地址池中不可用。
400InvalidIpv6CidrBlock.MalformedParam Ipv6CidrBlock is malformed.参数IPv6 网段不合法
400MissingParam.IpVersionThe parameter IpVersion is missing.参数IpVersion缺失。
400Mismatch.IpVersionAndIpamPoolIpVersionThe input IpVersion is inconsistent with the IpVersion of the input IPAM pool.输入的IpVersion和输入的地址池的IpVersion不一致。
400IllegalParam.Ipv6CidrBlockThe parameter of Ipv6CidrBlock is illegal.参数Ipv6CidrBlock非法。
400OperationFailed.Ipv6CidrBlockOverLappedThe input IPv6 CIDR block overlaps with the existing ones.输入的IPv6网段和现有的网段重叠。
400QuotaExceeded.IPv6CidrBlockThe number of IPv6 CIDR blocks in the VPC exceeds the limit.VPC中的IPv6网段数超过了限制。
400OperationDenied.MaskOfCidrIsNotAllowedThe input mask or mask of the input CIDR is not allowed.输入的掩码或CIDR的掩码不在允许的范围内。
400IllegalParam.Ipv6IspThe specified Ipv6Isp is illegal.指定的Ipv6Isp参数不合法。
400IllegalParam.CidrMaskThe input CIDR mask is illegal.指定的网段掩码不合法。
403ForbbidenUser not authorized to operate on the specified resource.用户没有权限操作指定的资源。
404ResourceNotFound.IpamPoolThe dependent IPAM pool is not found.依赖资源IPAM Pool不存在。
500OperationFailed.ResourceNotEnoughInsufficient resources.您申请的资源不足，如仍需申请，请提工单处理

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
2025-01-16OpenAPI 错误码发生变更、OpenAPI 返回结构发生变更查看变更详情
2024-12-30OpenAPI 错误码发生变更查看变更详情
2024-12-18OpenAPI 错误码发生变更查看变更详情
2024-08-28OpenAPI 错误码发生变更查看变更详情
2024-05-21OpenAPI 错误码发生变更查看变更详情
2024-04-25OpenAPI 错误码发生变更、OpenAPI 入参发生变更查看变更详情
2023-08-24OpenAPI 描述信息更新、OpenAPI 错误码发生变更查看变更详情
2023-04-14OpenAPI 错误码发生变更查看变更详情
2023-04-13OpenAPI 错误码发生变更、OpenAPI 入参发生变更查看变更详情
上一篇：GrantInstanceToCen - 为云企业网实例授权下一篇：AllocateVpcIpv6Cidr - 预留指定的IPv6地址段