為VPC添加附加網(wǎng)段。
接口說明
-
一個 VPC 最多支持添加的附加網(wǎng)段個數(shù)如下:
- 一個 VPC 最多支持添加 5 個附加 IPv4 網(wǎng)段。
- 一個 VPC 最多支持添加 5 個附加 IPv6 網(wǎng)段。
-
AssociateVpcCidrBlock 接口不支持并發(fā)為同一個 VPC 添加附加網(wǎng)段。
調(diào)試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權(quán)信息
下表是API對應(yīng)的授權(quán)信息,可以在RAM權(quán)限策略語句的Action
元素中使用,用來給RAM用戶或RAM角色授予調(diào)用此API的權(quán)限。具體說明如下:
- 操作:是指具體的權(quán)限點。
- 訪問級別:是指每個操作的訪問級別,取值為寫入(Write)、讀取(Read)或列出(List)。
- 資源類型:是指操作中支持授權(quán)的資源類型。具體說明如下:
- 對于必選的資源類型,用背景高亮的方式表示。
- 對于不支持資源級授權(quán)的操作,用
全部資源
表示。
- 條件關(guān)鍵字:是指云產(chǎn)品自身定義的條件關(guān)鍵字。
- 關(guān)聯(lián)操作:是指成功執(zhí)行操作所需要的其他權(quán)限。操作者必須同時具備關(guān)聯(lián)操作的權(quán)限,操作才能成功。
操作 | 訪問級別 | 資源類型 | 條件關(guān)鍵字 | 關(guān)聯(lián)操作 |
---|---|---|---|---|
vpc:AssociateVpcCidrBlock | create | *VPC acs:vpc:{#regionId}:{#accountId}:vpc/{#VpcId} |
| 無 |
請求參數(shù)
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
RegionId | string | 是 | 需要添加附加網(wǎng)段的 VPC 所在地域 ID。 您可以通過調(diào)用 DescribeRegions 接口獲取地域 ID。 | ch-hangzhou |
VpcId | string | 是 | 需要添加附加網(wǎng)段的 VPC 的 ID。 | vpc-o6wrloqsdqc9io3mg**** |
SecondaryCidrBlock | string | 否 | 需要添加的附加 IPv4 網(wǎng)段,網(wǎng)段要求如下:
配置限制如下:
說明
不通過 IPAM 地址池為 VPC 添加附加網(wǎng)段時,參數(shù) SecondaryCidrBlock 和參數(shù) Ipv6CidrBlock 必須輸入一個且不能都輸入。
| 192.168.0.0/16 |
SecondaryCidrMask | integer | 否 | 通過輸入掩碼的方式從 IPAM 地址池為 VPC 添加附加網(wǎng)段。 說明
指定 IPAM 地址池為 VPC 添加附加網(wǎng)段,參數(shù) SecondaryCidrBlock 或 SecondaryCidrMask 至少輸入一個。
| 16 |
IPv6CidrBlock | string | 否 | VPC 的指定 IPv6 網(wǎng)段。 說明
參數(shù) SecondaryCidrBlock 和參數(shù) Ipv6CidrBlock 必須輸入一個且不能都輸入。
| 2408:XXXX:0:6a::/56 |
Ipv6Isp | string | 否 | VPC 的 IPv6 地址段類型,取值:
說明
如果是開通了單線帶寬白名單的用戶,該字段可以設(shè)置為 ChinaTelecom(中國電信)、ChinaUnicom(中國聯(lián)通)和 ChinaMobile(中國移動)。
| BGP |
IpVersion | string | 否 | IP 地址的版本類型。取值:
| IPV4 |
IpamPoolId | string | 否 | IPv4 類型的 IPAM 地址池實例 ID。 | ipam-pool-sycmt3p2a9v63i**** |
返回參數(shù)
示例
正常返回示例
JSON
格式
{
"RequestId": "C1221A1F-2ACD-4592-8F27-474E02883159"
}
錯誤碼
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. | 該CIDR格式不正確。 |
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. | 缺少必填參數(shù)附加網(wǎng)段或者IPv6網(wǎng)段。 |
400 | MissingParam.VpcId | You must specify VpcId. | 缺少必填參數(shù)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. | 該交換機網(wǎng)段與其他交換機的網(wǎng)段重疊或與已有的自定義路由的目標(biāo)網(wǎng)段重疊,請使用其他未被占用的網(wǎng)段。 |
400 | IllegalParam.IpamPool | The specified IPAM pool cannot be empty. | IPAM Pool不可以為空。 |
400 | MissingParam.SecondaryCidrMask | The parameter SecondaryCidrMask must be input. | SecondaryCidrMask參數(shù)需要輸入。 |
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. | 操作被拒絕,因為未在地址池所在地域調(diào)用請求。 |
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. | 操作被拒絕,因為無法從不具備地域?qū)傩缘牡刂烦刂袆?chuàng)建VPC或為VPC添加附加網(wǎng)段。 |
400 | MissingParam.CidrOrCidrMask | The CIDR or CIDR Mask must be input. | 從IPAM地址池創(chuàng)建資源時,請輸入Cidr或CidrMask。 |
400 | OperationDenied.CidrInExcludeCidrs | The operation is not allowed because the input CIDR is within the illegal CIDRs. | 操作被拒絕,原因是輸入的CIDR在不合法的CIDR范圍內(nèi)。 |
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地址池中不可用。 |
403 | Forbbiden | User not authorized to operate on the specified resource. | 用戶沒有權(quán)限操作指定的資源。 |
404 | ResourceNotFound.IpamPool | The dependent IPAM pool is not found. | 依賴資源IPAM Pool不存在。 |
500 | OperationFailed.ResourceNotEnough | Insufficient resources. | 您申請的資源不足,如仍需申請,請?zhí)峁翁幚?/span> |
訪問錯誤中心查看更多錯誤碼。
變更歷史
變更時間 | 變更內(nèi)容概要 | 操作 |
---|---|---|
2024-12-18 | OpenAPI 錯誤碼發(fā)生變更 | 查看變更詳情 |
2024-08-28 | OpenAPI 錯誤碼發(fā)生變更 | 查看變更詳情 |
2024-05-21 | OpenAPI 錯誤碼發(fā)生變更 | 查看變更詳情 |
2024-04-25 | OpenAPI 錯誤碼發(fā)生變更、OpenAPI 入?yún)l(fā)生變更 | 查看變更詳情 |
2023-08-24 | OpenAPI 描述信息更新、OpenAPI 錯誤碼發(fā)生變更 | 查看變更詳情 |
2023-04-14 | OpenAPI 錯誤碼發(fā)生變更 | 查看變更詳情 |
2023-04-13 | OpenAPI 錯誤碼發(fā)生變更、OpenAPI 入?yún)l(fā)生變更 | 查看變更詳情 |