為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:AssociateVpcCidrBlock | create | *VPC acs:vpc:{#regionId}:{#accountId}:vpc/{#VpcId} |
| 無 |
請求參數
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
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 添加附加網段。 說明
指定 IPAM 地址池為 VPC 添加附加網段,參數 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 | 否 | IPv4 類型的 IPAM 地址池實例 ID。 | ipam-pool-sycmt3p2a9v63i**** |
返回參數
示例
正常返回示例
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. | 缺少必填參數附加網段或者IPv6網段。 |
400 | MissingParam.VpcId | You must specify VpcId. | 缺少必填參數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. | 該交換機網段與其他交換機的網段重疊或與已有的自定義路由的目標網段重疊,請使用其他未被占用的網段。 |
400 | IllegalParam.IpamPool | The specified IPAM pool cannot be empty. | IPAM Pool不可以為空。 |
400 | MissingParam.SecondaryCidrMask | The parameter SecondaryCidrMask must be input. | SecondaryCidrMask參數需要輸入。 |
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. | 操作被拒絕,因為未在地址池所在地域調用請求。 |
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. | 操作被拒絕,因為無法從不具備地域屬性的地址池中創建VPC或為VPC添加附加網段。 |
400 | MissingParam.CidrOrCidrMask | The CIDR or CIDR Mask must be input. | 從IPAM地址池創建資源時,請輸入Cidr或CidrMask。 |
400 | OperationDenied.CidrInExcludeCidrs | The operation is not allowed because the input CIDR is within the illegal CIDRs. | 操作被拒絕,原因是輸入的CIDR在不合法的CIDR范圍內。 |
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. | 用戶沒有權限操作指定的資源。 |
404 | ResourceNotFound.IpamPool | The dependent IPAM pool is not found. | 依賴資源IPAM Pool不存在。 |
500 | OperationFailed.ResourceNotEnough | Insufficient resources. | 您申請的資源不足,如仍需申請,請提工單處理 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
變更時間 | 變更內容概要 | 操作 |
---|---|---|
2024-12-18 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
2024-08-28 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
2024-05-21 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
2024-04-25 | OpenAPI 錯誤碼發生變更、OpenAPI 入參發生變更 | 查看變更詳情 |
2023-08-24 | OpenAPI 描述信息更新、OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
2023-04-14 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
2023-04-13 | OpenAPI 錯誤碼發生變更、OpenAPI 入參發生變更 | 查看變更詳情 |