調用CreateVirtualNode創建一個虛擬節點（VNode），用于對接自建Kubernetes集群，使其可以擴展資源到ECI。
接口說明
-
調用本接口創建虛擬節點時，系統將自動為您創建一個服務關聯角色 AliyunServiceRoleForECIVnode，用于訪問 ECI、ECS、VPC 等相關云服務。更多信息，請參見虛擬節點服務關聯角色。
-
虛擬節點按個數計費。每個虛擬節點會有一個常駐節點，相當于 2 vCPU，8 GiB 的 ECI 實例，收取相關 ECI 實例費用。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息，可以在RAM權限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下：
- 操作：是指具體的權限點。
- 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權的操作，用
全部資源表示。
- 條件關鍵字：是指云產品自身定義的條件關鍵字。
- 關聯操作：是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
|---|---|---|---|---|
| eci:CreateVirtualNode | create | *VirtualNode acs:eci:{#regionId}:{#accountId}:virtualnode/* |
| 無 |
請求參數
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| RegionId | string | 是 | 地域 ID。 | cn-hangzhou |
| ZoneId | string | 否 | 可用區 ID。 | cn-hangzhou-b |
| SecurityGroupId | string | 是 | 安全組 ID。虛擬節點以及該虛擬節點下的 ECI 實例將加入到該安全組中。 | sg-2ze81zoc3yl7a3we**** |
| VSwitchId | string | 是 | 交換機 ID。虛擬節點以及虛擬節點下的 ECI 實例所使用的交換機。 | vsw-2ze23nqzig8inprou**** |
| VirtualNodeName | string | 否 | 虛擬節點的名稱。長度為 2~128 個英文字符，可以包含小寫英文字符、數字、半角句號（.）或者短劃線（-）。 | testNode |
| ResourceGroupId | string | 否 | 資源組 ID。 | rg-uf66jeqopgqa9hdn**** |
| ClientToken | string | 否 | 保證請求冪等性。從您的客戶端生成一個參數值，確保不同請求間該參數值唯一。只支持 ASCII 字符，且不能超過 64 個字符。更多詳情，請參見如何保證冪等性。 | 123e4567-e89b-12d3-a456-426655440000 |
| EnablePublicNetwork | boolean | 否 | 是否支持公網。默認為 false。 | false |
| EipInstanceId | string | 否 | 彈性公網 IP 的 ID。 | eip-uf66jeqopgqa9hdn**** |
| KubeConfig | string | 否 | 虛擬節點要連接的 Kubernetes 集群的 KubeConfig。需進行 Base64 編碼后傳入。 | JTVDbmFwaVZlcnNpb24lM0ElMjB2MSU1Q25jbHVzdGVycyUzQSU1Q24tJTIwY2x1c3RlciUzQSU1Q24uLi****** |
| CustomResources | string | 否 | 虛擬節點支持的自定義資源。如果 ECI Pod 的 request 中聲明了相應的自定義資源，則該 Pod 會被調度到 VNode。
格式為 | example1.com=100,example2.com=200 |
| ClusterDomain | string | 否 | 集群的域名。配置后，除了主機的搜索域外，Kubelet 會配置所有容器來搜索該域名。 | example.com |
| ClusterDNS | string | 否 | DNS 服務器的 IP 地址。如果 ECI Pod 中設置了 | 100.1.XX.XX |
| Tag | array<object> | 否 | 虛擬節點標簽信息。最多可以配置 20 個。 | |
| object | 否 | 虛擬節點標簽信息。 | ||
| Key | string | 否 | 標簽鍵。 | name |
| Value | string | 否 | 標簽值。 | test |
| Taint | array<object> | 否 | 虛擬節點污點信息。最多可以配置 20 個。 | |
| object | 否 | 虛擬節點污點信息。 | ||
| Key | string | 否 | 污點的 Key。 | testKey |
| Value | string | 否 | 污點的 Value。 | testValue |
| Effect | string | 否 | 污點的 Effect。取值范圍：
| NoSchedule |
| TlsBootstrapEnabled | boolean | 否 | 是否啟用 TLS 啟動引導。啟用后，請使用 TLS 啟動引導的 KubeConfig 證書。取值范圍：
默認為 false。 | false |
返回參數
示例
正常返回示例
JSON格式
{
"RequestId": "89164E78-FC82-4684-BE97-DCDD85D26546",
"VirtualNodeId": "vnd-2ze960zkdqrldeaw****"
}錯誤碼
| HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
|---|---|---|---|
| 400 | Account.Arrearage | Your account has an outstanding payment. | 賬號已經欠費。 |
| 400 | DryRunOperation | Request validation has been passed with DryRun flag set. | 此次DryRun預檢請求合格。 |
| 400 | InvalidParameter.CPU.Memory | The specified cpu and memory are not allowed | - |
| 400 | InvalidParameter.DuplicatedName | The container group include containers with duplicate names. | 容器組內有重復名字的容器。 |
| 400 | InvalidParameter.DuplicatedVolumeName | The container group includes volumes with duplicate names. | 容器組內有重復名字的數據卷。 |
| 400 | IncorrectStatus | %s | 指定的實例狀態不正確。 |
| 400 | ServiceNotEnabled | %s | 該次請求所依賴的服務沒有開通，請開通后再試。 |
| 400 | ImageSnapshot.IncorrectStatus | %s | 用于鏡像緩存的快照狀態不正確。 |
| 400 | ImageSnapshot.NotSupport | %s | 基于數據盤快照的鏡像緩存功能暫未全網開放，如有需要請聯系我們。 |
| 400 | DiskVolume.NotSupport | The disk volume is not supported. | 云盤卷暫不支持，如有需要請聯系我們。 |
| 400 | RamRole.NotSupport | The RAM role is not supported. | ram實例角色不支持。 |
| 400 | DiskNumber.LimitExceed | The maximum number of disks in an instance is exceeded. | 實例下云盤數目超過限制。 |
| 400 | InvalidPaymentMethod.InsufficientBalance | No payment method is specified for your account. We recommend that you add a payment method or add funds to the prepayment balance. | 您的賬戶暫無有效支付方式，請添加支付方式或保持預付款余額充足。 |
| 400 | DiskVolume.NotInSameZone | The instance to be created and the disk are not in the same zone. | 即將創建的實例和云盤不在同一可用區。 |
| 400 | NoPermission | You are not authorized to use the "Product on ECI" feature. | - |
| 400 | HighCpuMemConfigRequired | You need to apply to be added to the whitelist of the specified CPU and memory. | 您需要申請CPU高配白名單。 |
| 400 | RecommendEmpty.InstanceTypeFamilyNotMatched | The recommended instance type is unavailable in the current zone. Try again later. | 當前可用區沒有推薦的規格可使用，請稍后重試或者到其他的可用區創建。 |
| 400 | LocalDiskAmountNotMatch | The number of local volumes does not match the instance type. | 本地盤數量跟實例規格不匹配 |
| 400 | Payfor.CreditPayInsufficientBalance | Your payment credit line is insufficient. | 您的付款信用額度不足。 |
| 400 | InvalidOperation.KMS.InstanceTypeNotSupport | The specified instance is invalid. Only I/O optimized instances support KMS key. | 指定的實例無效，只有 I/O 優化類型的實例支持設置“KMS Key”。 |
| 400 | InvalidParameter.Encrypted.KmsNotEnabled | KMS must be enabled for encrypted disks. | 加密磁盤需要啟用密鑰管理服務。 |
| 400 | InvalidParameter.KMS.EncryptedIllegal | After configuring the parameter KmsKeyId, you must enable encryption. | 設置參數“KmsKeyId”后，您必須開啟加密屬性。 |
| 400 | Ipv6AddressNotSupportVsw | IPv6 is not supported in the specified vSwitch. | 該交換機暫未開通ipv6地址。 |
| 400 | EipAddressPoolIpNotEnough | The ip address of specified PublicIpAddressPool is not enough. | 指定的eip公網地址池地址資源不足。 |
| 400 | VnodeDedicatedHostIdAlreadyExist | DedicatedHostId:%s of Vnode:%s already exists. | DedicatedHostId已經存在 |
| 400 | DedicatedHostQuotaExceeded | The quota of DedicatedHost is exceeded. | 專有宿主機的quota超過限制 |
| 403 | OperationDenied.VswZoneMisMatch | The specified VSwitchId is not in the specified Zone. | - |
| 403 | QuotaExceeded | %s quota exceeded. | 用戶允許創建的實例已經超過限制。 |
| 403 | Zone.NotOnSale | The specified zone is not available for purchase. | 創建實例的可用區已經關閉售賣，請更換其他可用區。或者無法在該可用區使用指定 VPC 的虛擬交換機。 |
| 403 | Forbidden.RiskControl | This operation has been identified as an abnormal operation and cannot be processed. | 此操作已被確定為一個操作異常，無法處理。 |
| 403 | Forbidden.SubUser | The specified action is not available for you. | 當前用戶無法執行該操作。 |
| 403 | Forbidden.OnlyForInvitedTest | Eci create action is only open to invited users during public beta. | Eci公測階段只對受邀的用戶開放。 |
| 403 | OperationDenied.SecurityGroupMisMatch | The specified VSwitchId and SecurityGroupId are not in the same VPC. | 指定的交換機和安全組不在同一個VPC下。 |
| 403 | InvalidVSwitchId.IpNotEnough | The specified VSwitch does not have enough IP addresses. | - |
| 403 | Forbidden.UserBussinessStatus | This operation is not allowed, because you have overdue bills. Pay the overdue bill and try again. | 用戶處于欠費狀態不允許創建，請充值后再嘗試。 |
| 403 | Forbidden.UserNotRealNameAuthentication | This operation is not allowed, because you have not passed the real-name verification. | 操作被禁止，因為用戶還未進行實名認證。 |
| 403 | InvalidUser.PassRoleForbidden | The RAM user is not authorized to assume a RAM role. | 子賬號用戶沒有權限使用RAM實例角色。 |
| 403 | NoPermission | The RAM role does not belong to ECS. | - |
| 403 | OperationDenied.NoStock | Sales of this resource are temporarily suspended in the specified zone. We recommend that you use the multi-zone creation function to avoid the risk of insufficient resource. For more information, see http://bestwisewords.com/document_detail/157290.html | - |
| 403 | InvalidParameter.KMS.KeyId.Forbidden | You are not authorized to access the specified KMSKeyId. | 無權訪問指定的 KMSKeyId。 |
| 403 | NoPermission | The RAM role AliyunECIContainerGroupRole does not belong to eci.aliyuncs.com. Please check and try again. | - |
| 403 | Forbidden.AccountClosed | The operation is forbidden. Your account has been closed. | 操作被禁止，因為用戶賬戶已注銷。 |
| 403 | InvalidOperation.ResourceManagedByCloudProduct | The operation is forbidden. The security group has been managed by another cloud product. | 安全組由其他云產品管理，禁止操作。 |
| 403 | Spot.NotMatched | %s. We recommend that you use the create multi-zone function to avoid insufficient inventory. For more information, see http://bestwisewords.com/document_detail/157290.html | - |
| 403 | SecurityRisk.3DVerification | We have detected a security risk with your default credit or debit card. Please proceed with verification via the link in your email. | 我們檢測到您的默認信用卡或借記卡存在安全風險。請通過電子郵件中的鏈接進行驗證。 |
| 403 | CreateServiceLinkedRole.Denied | Please make sure the account has ram:CreateServiceLinkedRole permission. | 請確保賬號擁有ram:CreateServiceLinkedRole權限。 |
| 404 | ImageSnapshot.NotFound | The specified snapshot does not exist. | 鏡像緩存，快照不存在。 |
| 404 | InvalidDiskId.NotFound | The specified disk does not exist. | 指定的云盤不存在。 |
| 404 | InvalidParameter.KMS.KeyId.NotFound | The specified KMSKeyId does not exist. | 指定的參數“KMSKeyId”不存在。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內容概要 | 操作 |
|---|---|---|
| 2023-07-03 | OpenAPI 錯誤碼發生變更、OpenAPI 入參發生變更 | 查看變更詳情 |
| 2023-06-13 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
| 2021-09-06 | 新增 OpenAPI | 查看變更詳情 |