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

AssociateVpcCidrBlock - 为VPC添加附加IPv4网段

更新时间：
一键部署
产品详情
相关技术圈
我的收藏

为VPC添加IPv4附加网段。

接口说明

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

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

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

调试

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

授权信息

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

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

请求参数

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

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

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

ch-hangzhou
VpcIdstring是

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

vpc-o6wrloqsdqc9io3mg****
SecondaryCidrBlockstring否

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

  • 使用 192.168.0.0/16、172.16.0.0/12 和 10.0.0.0/8 三个标准网段及其子网作为 VPC 的附加 IPv4 网段。
  • 使用除 100.64.0.0/10、224.0.0.0/4、127.0.0.0/8、169.254.0.0/16 及其子网外的自定义地址段作为专有网络的附加 IPv4 网段。

配置限制如下：

  • 不能以 0 开头，掩码长度有效范围为 8~28 位。

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

说明 参数 SecondaryCidrBlock 和参数 Ipv6CidrBlock 必须输入一个且不能都输入。
192.168.0.0/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否

IPv4 类型的 IPAM 地址池实例 ID。

ipam-pool-sycmt3p2a9v63i****

返回参数

名称类型描述示例值
object

请求 ID。

RequestIdstring

请求 ID。

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

示例

正常返回示例

JSON格式

{
  "RequestId": "C1221A1F-2ACD-4592-8F27-474E02883159"
}

错误码

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资源不足。
403ForbbidenUser not authorized to operate on the specified resource.用户没有权限操作指定的资源。
404ResourceNotFound.IpamPoolThe dependent IPAM pool is not found.依赖资源IPAM Pool不存在。
500OperationFailed.ResourceNotEnoughInsufficient resources.您申请的资源不足，如仍需申请，请提工单处理

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

变更历史

变更时间变更内容概要操作
2023-08-24OpenAPI 描述信息更新、OpenAPI 错误码发生变更看变更集
变更项变更内容
API 描述OpenAPI 描述信息更新。
错误码OpenAPI 错误码发生变更。
    错误码 400 变更
    删除错误码：403
    删除错误码：500
2023-04-14OpenAPI 错误码发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更。
    删除错误码：400
    删除错误码：403
    新增错误码：500
2023-04-13OpenAPI 错误码发生变更、OpenAPI 入参发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更。
    删除错误码：400
    删除错误码：403
入参OpenAPI 入参发生变更。
    新增入参：IpamPoolId
文档推荐
  • 本页导读 （1）
文档反馈