You need to enable JavaScript to run this app.
导航
AssociateVpcCidrBlock
最近更新时间:2024.07.09 08:30:23首次发布时间:2023.01.06 07:46:50

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

调用说明

  • 单个VPC最多可添加的辅助CIDR数量为1个。
  • 辅助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 表示配置完成。

调试

请求参数

参数名称
类型
是否必选
示例值
描述
ActionStringAssociateVpcCidrBlock要执行的操作,取值为AssociateVpcCidrBlock。
VersionString2020-04-01API版本信息,当前版本为2020-04-01。

VpcId

String

vpc-257gqcdfvx6n****

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

SecondaryCidrBlock

String

172.16.XX.0/24

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

  • 192.168.0.0/16~24
  • 10.0.0.0/8~24
  • 172.16.0.0/12~24

说明

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

返回数据

参数名称
类型
示例值
描述
RequestIdString2021062415303301022514515207C4****请求ID。
VpcIdStringvpc-257gqcdfvx6n****VPC的ID。
SecondaryCidrBlocksArray["172.16.1.0/24", "172.16.2.0/24"]VPC的辅助网段。

请求示例

GET /?Action=AssociateVpcCidrBlock&Version=2020-04-01&VpcId=vpc-257gqcdfvx6n****&SecondaryCidrBlock=172.16.XX.0/24  HTTP/1.1
Host: open.volcengineapi.com
Service: vpc
Region: cn-beijing

返回示例

{
    "ResponseMetadata": {
        "RequestId": "2021062415303301022514515207C4****",
        "Action": "AssociateVpcCidrBlock",
        "Version": "2020-04-01",
        "Service": "vpc",
        "Region": "cn-beijing"
    },
    "Result": {
        "RequestId": "2021062415303301022514515207C4****",
        "VpcId": "vpc-257gqcdfvx6n****",
        "SecondaryCidrBlocks": [
            "172.16.1.0/24",
            "172.16.2.0/24"
        ]
    }
}

错误码

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

HttpCode
错误码
错误信息
描述
400InvalidCidr.MalformedThe specified cidr block is malformed.指定的网段格式不合法。
400InvalidVpc.InvalidStatusThe specified VPC is not in the correct status for the request.指定的VPC所处状态无法响应该请求。
400QuotaExceeded.VpcSecondaryCidrYou've reached the limit on the number of secondary cidr blocks per VPC.已达到VPC下辅助网段的数量上限。
404InvalidVpc.NotFoundThe specified VPC does not exist.指定的VPC不存在。
409InvalidSecondaryCidrBlock.ConflictThe specified secondary CIDR block conflicts with that of another block in your VPC.指定的辅助CIDR地址块与所属VPC中另一个CIDR地址块冲突。