全部產品
Search

搜尋本產品

    Elastic Container Instance：CreateVirtualNode - 建立一個虛擬節點

    文件中心

    Elastic Container Instance：CreateVirtualNode - 建立一個虛擬節點

    更新時間：Oct 31, 2025

    建立一個虛擬節點（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/*
    • eci:tag
    		 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    RegionId

    string

    是

    地區 ID。

    cn-hangzhou
    ZoneId

    string

    否

    可用性區域 ID。

    cn-hangzhou-b
    SecurityGroupId

    string

    是

    安全性群組 ID。虛擬節點以及該虛擬節點下的 ECI 執行個體將加入到該安全性群組中。

    sg-2ze81zoc3yl7a3we****
    VSwitchId

    string

    是

    交換器 ID。虛擬節點以及虛擬節點下的 ECI 執行個體所使用的交換器。
    支援指定多個（1~10 個）屬於同一 VPC 的交換器。

    vsw-2ze23nqzig8inprou****
    VirtualNodeName

    string

    否

    虛擬節點的名稱。長度為 2~128 個英文字元，可以包含小寫英文字元、數字、半形句號（.）或者短劃線（-）。

    testNode
    ResourceGroupId

    string

    否

    資源群組 ID。

    rg-uf66jeqopgqa9hdn****
    ClientToken

    string

    否

    保證請求等冪性。從您的用戶端產生一個參數值，確保不同請求間該參數值唯一。只支援 ASCII 字元，且不能超過 64 個字元。更多詳情，請參見如何保證等冪性。

    123e4567-e89b-12d3-a456-426655440000
    EnablePublicNetwork

    boolean

    否

    是否支援公網。預設為 false。
    如果設定為 true，則虛擬節點將對外暴露一個公網 IP。

    false
    EipInstanceId

    string

    否

    彈性公網 IP 的 ID。

    eip-uf66jeqopgqa9hdn****
    KubeConfig

    string

    否

    虛擬節點要串連的 Kubernetes 叢集的 KubeConfig。需進行 Base 64 編碼後傳入。

    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 中設定了dnsPolicy=ClusterFirst，則使用該配置值為容器提供 DNS 服務。 支援配置多個 IP 位址，多個 IP 位址之間使用半形逗號間隔。

    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：不將 Pod 調度到具有該汙點的節點上。

    • NoExecute：不將 Pod 調度到具有該汙點的節點上的同時，驅逐節點上已經存在的 Pod。

    • PreferNoSchedule：盡量不將 Pod 調度到具有該汙點的節點上。

    NoSchedule
    TlsBootstrapEnabled

    boolean

    否

    是否啟用 TLS 啟動引導。啟用後，請使用 TLS 啟動引導的 KubeConfig 認證。取值範圍：

    • true：啟用

    • false：不啟用

    預設為 false。

    false

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    返回資訊。

    RequestId

    string

    請求 ID。

    89164E78-FC82-4684-BE97-DCDD85D26546
    VirtualNodeId

    string

    虛擬節點 ID。

    vnd-2ze960zkdqrldeaw****

    樣本

    正常返回樣本

    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. 加密磁碟需要啟用Key Management Service。
    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. Dedicated Host的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.
    403 OperationDenied.SecurityGroupMisMatch The specified VSwitchId and SecurityGroupId are not in the same 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 https://www.alibabacloud.com/help/document_detail/157290.html
    403 InvalidParameter.KMS.KeyId.Forbidden You are not authorized to access the specified KMSKeyId. 無權訪問指定的 KMSKeyId。
    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 https://www.alibabacloud.com/help/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”不存在。

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    更多資訊，參考變更詳情。