AssociateVpcCidrBlock
為 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. | |
| 400 | MissingParam.VpcId | You must specify VpcId. | |
| 400 | UnsupportedFeature.Ipv6Isp | The Ipv6Isp feature is not supported. | |
| 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. | |
| 400 | MissingParam.SecondaryCidrMask | The parameter SecondaryCidrMask must be input. | |
| 400 | IllegalParam.SecondaryCidrMask | The specified Secondary CIDR Mask is illegal. | |
| 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. | |
| 400 | MissingParam.CidrOrCidrMask | The CIDR or CIDR Mask must be input. | |
| 400 | OperationDenied.CidrInExcludeCidrs | The operation is not allowed because the input CIDR is within the illegal CIDRs. | |
| 400 | OperationDenied.AvailableCidrInsufficient | The operation is not allowed because available CIDR is insufficient. | |
| 400 | UnsupportedFeature.Ipam | IPAM is not supported in this region. | |
| 400 | UnsupportedFeature.VpcIpamIpv6 | The specified IPAM pool does not support the IPv6 feature. | |
| 400 | OperationDenied.CidrUnavailableInPool | The operation is not allowed because the CIDR is unavailable in the IPAM pool. | |
| 400 | InvalidIpv6CidrBlock.Malformed | Param Ipv6CidrBlock is malformed. | |
| 400 | MissingParam.IpVersion | The parameter IpVersion is missing. | |
| 400 | Mismatch.IpVersionAndIpamPoolIpVersion | The input IpVersion is inconsistent with the IpVersion of the input IPAM pool. | |
| 400 | IllegalParam.Ipv6CidrBlock | The parameter of Ipv6CidrBlock is illegal. | |
| 400 | OperationFailed.Ipv6CidrBlockOverLapped | The input IPv6 CIDR block overlaps with the existing ones. | |
| 400 | QuotaExceeded.IPv6CidrBlock | The number of IPv6 CIDR blocks in the VPC exceeds the limit. | |
| 400 | OperationDenied.MaskOfCidrIsNotAllowed | The input mask or mask of the input CIDR is not allowed. | |
| 400 | IllegalParam.Ipv6Isp | The specified Ipv6Isp is illegal. | |
| 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. |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊，參考變更詳情。