All Products
Search

This Product

    Elastic Container Instance:CreateVirtualNode

    Document Center

    Elastic Container Instance:CreateVirtualNode

    Last Updated:Jun 10, 2026

    Membuat node virtual untuk menghubungkan kluster Kubernetes yang dikelola sendiri ke ECI dan melakukan scale out Sumber daya.

    Deskripsi operasi

    • When you call this operation to create a virtual node, the system automatically creates a service-linked role named AliyunServiceRoleForECIVnode. This role allows access to related Alibaba Cloud services, such as ECI, ECS, and VPC. For more information, see Service-linked role for virtual nodes.

    • Virtual nodes are billed based on their quantity. Each virtual node includes a resident node that is equivalent to an ECI instance with 2 vCPUs and 8 GiB of memory. You are charged instance fees for this ECI instance.

    Coba sekarang

    Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

    Test

    RAM authorization

    Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

    • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

    • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

    • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

    • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

      • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

      • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

    • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

    • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    eci:CreateVirtualNode

    create

    *VirtualNode

    acs:eci:{#regionId}:{#accountId}:virtualnode/*
    • eci:tag
    		 None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    Yes

    ID zona.

    cn-hangzhou
    ZoneId

    string

    No

    The ID of the zone.

    cn-hangzhou-b
    SecurityGroupId

    string

    Yes

    ID grup keamanan. Node virtual dan Instans ECI di node virtual ditambahkan ke grup keamanan ini.

    sg-2ze81zoc3yl7a3we****
    VSwitchId

    string

    Yes

    ID vSwitch yang digunakan oleh node virtual dan Instans ECI di node virtual.
    Anda dapat menentukan 1 hingga 10 vSwitch yang termasuk dalam VPC yang sama.
    .

    vsw-2ze23nqzig8inprou****
    VirtualNodeName

    string

    No

    Nama node virtual. Nama harus sepanjang 2 hingga 128 karakter dan dapat berisi huruf kecil, angka, titik (.), dan tanda hubung (-).

    testNode
    ResourceGroupId

    string

    No

    ID kelompok sumber daya.

    rg-uf66jeqopgqa9hdn****
    ClientToken

    string

    No

    Memastikan idempotensi permintaan. Nilai dihasilkan oleh Klien. Anda harus memastikan bahwa nilai tersebut unik untuk setiap permintaan. Nilai hanya dapat berisi karakter ASCII dan tidak boleh lebih dari 64 karakter. Untuk informasi lebih lanjut, lihat Cara memastikan idempotensi.

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

    boolean

    No

    Apakah akan mengaktifkan akses internet. Nilai default: false.
    Jika Anda mengatur parameter ini ke true, node virtual akan ditetapkan alamat IP publik.
    .

    false
    EipInstanceId

    string

    No

    ID elastic IP address (EIP).

    eip-uf66jeqopgqa9hdn****
    KubeConfig

    string

    No

    KubeConfig kluster Kubernetes yang terhubung ke node virtual. Nilai harus dienkode Base64.

    JTVDbmFwaVZlcnNpb24lM0ElMjB2MSU1Q25jbHVzdGVycyUzQSU1Q24tJTIwY2x1c3RlciUzQSU1Q24uLi******
    CustomResources

    string

    No

    Resource kustom yang didukung oleh node virtual. Jika Pod ECI mendeklarasikan Resource kustom yang sesuai di permintaannya, Pod tersebut dijadwalkan ke node virtual. Tentukan nilai dalam format resource name=resource count. Pisahkan beberapa Sumber daya dengan koma (,).

    example1.com=100,example2.com=200
    ClusterDomain

    string

    No

    Nama domain kluster. Setelah Anda mengonfigurasi parameter ini, kubelet mengonfigurasi semua Kontainer untuk mencari nama domain ini selain domain pencarian Host.

    example.com
    ClusterDNS

    string

    No

    Alamat IP server DNS. Jika dnsPolicy=ClusterFirst diatur untuk Pod ECI, Pod tersebut menggunakan alamat IP ini untuk resolusi DNS. Anda dapat menentukan beberapa alamat IP. Pisahkan dengan koma (,).

    100.1.XX.XX
    Tag

    array<object>

    No

    Tag yang ditambahkan ke node virtual. Anda dapat menentukan maksimum 20 tag.

    object

    No

    The taints to apply to the virtual node.

    Key

    string

    No

    The key of the tag.

    name
    Value

    string

    No

    The value of the tag.

    test
    Taint

    array<object>

    No

    Taint node virtual. Anda dapat menentukan maksimum 20 taint.

    object

    No

    The taints to apply to the virtual node.

    Key

    string

    No

    The key of the tag.

    testKey
    Value

    string

    No

    The value of the tag.

    testValue
    Effect

    string

    No

    The effect of the taint. Valid values: - NoSchedule: Pods cannot be scheduled to the tainted node. - NoExecute: Pods cannot be scheduled to the tainted node, and existing pods on the node are evicted. - PreferNoSchedule: Pods are preferentially not scheduled to the tainted node.

    NoSchedule
    TlsBootstrapEnabled

    boolean

    No

    Apakah akan mengaktifkan TLS bootstrapping. Jika Anda mengatur parameter ini ke true, Sertifikat KubeConfig digunakan untuk TLS bootstrapping. Nilai valid:

    • true: Diaktifkan.

    • false: Dinonaktifkan.

    Nilai default: false.

    false

    Elemen respons

    Element

    Type

    Description

    Example

    object

    The response.

    RequestId

    string

    The request ID.

    89164E78-FC82-4684-BE97-DCDD85D26546
    VirtualNodeId

    string

    The virtual node ID.

    vnd-2ze960zkdqrldeaw****

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "89164E78-FC82-4684-BE97-DCDD85D26546",
  "VirtualNodeId": "vnd-2ze960zkdqrldeaw****"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 Account.Arrearage Your account has an outstanding payment. Your account has an outstanding payment.
    400 DryRunOperation Request validation has been passed with DryRun flag set. Request validation has been passed with DryRun flag set.
    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. The container group includes volumes with duplicate names.
    400 IncorrectStatus %s
    400 ServiceNotEnabled %s The service on which this request depends has not been activated. Please activate and try again.
    400 ImageSnapshot.IncorrectStatus %s The status of the specified snapshot is invalid.
    400 ImageSnapshot.NotSupport %s Image caching based on data disk snapshots is not available for all users. If you want to enable this function, contact us.
    400 DiskVolume.NotSupport The disk volume is not supported. Disk volume does not support your structure. If you want to enable this function, contact us.
    400 RamRole.NotSupport The RAM role is not supported. The RAM role is not supported.
    400 DiskNumber.LimitExceed The maximum number of disks in an instance is exceeded. 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. 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. 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. You need to apply to be added to the whitelist of the specified CPU and memory.
    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. Your payment credit line is insufficient.
    400 InvalidOperation.KMS.InstanceTypeNotSupport The specified instance is invalid. Only I/O optimized instances support KMS key. The specified instance is invalid. Only I/O optimized instances support 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. After configuring the parameter KmsKeyId, you must enable encryption.
    400 Ipv6AddressNotSupportVsw IPv6 is not supported in the specified vSwitch.
    400 EipAddressPoolIpNotEnough The ip address of specified PublicIpAddressPool is not enough.
    400 VnodeDedicatedHostIdAlreadyExist DedicatedHostId:%s of Vnode:%s already exists.
    400 DedicatedHostQuotaExceeded The quota of DedicatedHost is exceeded.
    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.
    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. The RAM user is not authorized to assume a RAM role.
    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. You are not authorized to access the specified 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. Please make sure the account has ram:CreateServiceLinkedRole permission.
    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. The specified KMSKeyId does not exist.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.