All Products
Search

This Product

    Elastic Container Instance:CreateVirtualNode

    Document Center

    Elastic Container Instance:CreateVirtualNode

    Last Updated:Aug 29, 2026

    Membuat virtual node (VNode) untuk menghubungkan kluster Kubernetes yang dikelola sendiri, sehingga memungkinkan kluster tersebut melakukan penskalaan sumber daya ke Elastic Container Instance (ECI).

    Deskripsi operasi

    • Saat Anda memanggil operasi ini untuk membuat virtual node, sistem secara otomatis membuat peran terkait layanan bernama AliyunServiceRoleForECIVnode guna mengakses layanan cloud terkait seperti ECI, ECS, dan VPC. Untuk informasi selengkapnya, lihat Peran terkait layanan untuk virtual node.

    • Penagihan virtual node didasarkan pada jumlahnya. Setiap virtual node memiliki node resident yang setara dengan instans ECI berkapasitas 2 vCPU dan memori 8 GiB. Anda akan dikenai biaya instans ECI yang sesuai.

    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 wilayah.

    cn-hangzhou
    ZoneId

    string

    No

    ID zona.

    cn-hangzhou-b
    SecurityGroupId

    string

    Yes

    ID security group. Virtual node dan instans ECI yang dibuat pada virtual node tersebut akan ditambahkan ke security group ini.

    sg-2ze81zoc3yl7a3we****
    VSwitchId

    string

    Yes

    ID vSwitch. vSwitch yang digunakan oleh virtual node dan instans ECI yang dibuat pada virtual node tersebut. Anda dapat menentukan 1 hingga 10 vSwitch yang termasuk dalam VPC yang sama.

    vsw-2ze23nqzig8inprou****
    VirtualNodeName

    string

    No

    Nama virtual node. Nama harus terdiri dari 2 hingga 128 karakter dan hanya boleh berisi huruf kecil, angka, titik (.), dan tanda hubung (-).

    testNode
    ResourceGroupId

    string

    No

    ID kelompok sumber daya.

    rg-uf66jeqopgqa9hdn****
    ClientToken

    string

    No

    Token klien yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menghasilkan token ini di sisi klien, tetapi pastikan token tersebut unik di antara permintaan yang berbeda. Token hanya boleh berisi karakter ASCII dan panjangnya tidak boleh melebihi 64 karakter. Untuk informasi selengkapnya, lihat Cara memastikan idempotensi.

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

    boolean

    No

    Menentukan apakah akses jaringan publik diaktifkan. Nilai default: false. Jika Anda mengatur parameter ini ke true, virtual node akan mengekspos alamat IP publik.

    false
    EipInstanceId

    string

    No

    ID Elastic IP Address (EIP).

    eip-uf66jeqopgqa9hdn****
    KubeConfig

    string

    No

    KubeConfig dari kluster Kubernetes tempat virtual node terhubung. Nilainya harus dikodekan Base64 sebelum dikirimkan.

    JTVDbmFwaVZlcnNpb24lM0ElMjB2MSU1Q25jbHVzdGVycyUzQSU1Q24tJTIwY2x1c3RlciUzQSU1Q24uLi******
    CustomResources

    string

    No

    Resource kustom yang didukung oleh virtual node. Jika Pod ECI mendeklarasikan resource kustom yang sesuai dalam permintaannya, Pod tersebut akan dijadwalkan ke VNode. Formatnya adalah resource_name=resource_count. Pisahkan beberapa resource dengan koma (,).

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

    string

    No

    Nama domain kluster. Setelah parameter ini dikonfigurasi, Kubelet mengonfigurasi semua kontainer untuk mencari domain ini selain domain pencarian host.

    example.com
    ClusterDNS

    string

    No

    Alamat IP Server DNS. Jika dnsPolicy=ClusterFirst diatur dalam Pod ECI, nilai ini digunakan untuk menyediakan layanan DNS bagi kontainer. Anda dapat menentukan beberapa alamat IP. Pisahkan beberapa alamat IP dengan koma (,).

    100.1.XX.XX
    Tag

    array<object>

    No

    Informasi tag virtual node. Anda dapat menentukan hingga 20 tag.

    object

    No

    Informasi tag virtual node.

    Key

    string

    No

    Kunci tag.

    name
    Value

    string

    No

    Nilai tag.

    test
    Taint

    array<object>

    No

    Informasi taint virtual node. Anda dapat menentukan hingga 20 taint.

    object

    No

    Informasi taint virtual node.

    Key

    string

    No

    Kunci taint.

    testKey
    Value

    string

    No

    Nilai taint.

    testValue
    Effect

    string

    No

    Efek taint. Nilai yang valid:

    • NoSchedule: Pod tidak dijadwalkan ke node yang memiliki taint ini.

    • NoExecute: Pod tidak dijadwalkan ke node yang memiliki taint ini, dan Pod yang sudah ada di node tersebut akan diusir.

    • PreferNoSchedule: Pod sebaiknya tidak dijadwalkan ke node yang memiliki taint ini.

    NoSchedule
    TlsBootstrapEnabled

    boolean

    No

    Menentukan apakah TLS bootstrapping diaktifkan. Jika Anda mengaktifkan fitur ini, gunakan sertifikat KubeConfig untuk TLS bootstrapping. Nilai yang valid:

    • true: diaktifkan.

    • false: dinonaktifkan.

    Nilai default: false.

    false

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Parameter respons.

    RequestId

    string

    ID permintaan.

    89164E78-FC82-4684-BE97-DCDD85D26546
    VirtualNodeId

    string

    ID virtual node.

    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. Akun memiliki pembayaran tertunda.
    400 DryRunOperation Request validation has been passed with DryRun flag set. Permintaan Pemeriksaan Awal dry run valid.
    400 InvalidParameter.CPU.Memory The specified cpu and memory are not allowed
    400 InvalidParameter.DuplicatedName The container group include containers with duplicate names. Kelompok kontainer berisi kontainer dengan nama duplikat.
    400 InvalidParameter.DuplicatedVolumeName The container group includes volumes with duplicate names. Kelompok kontainer berisi volume dengan nama duplikat.
    400 IncorrectStatus %s Status instans yang ditentukan tidak valid.
    400 ServiceNotEnabled %s Layanan yang diperlukan oleh permintaan ini belum diaktifkan. Aktifkan layanan tersebut dan coba lagi.
    400 ImageSnapshot.IncorrectStatus %s Snapshot yang digunakan untuk cache gambar tidak berada dalam status yang benar.
    400 ImageSnapshot.NotSupport %s Fitur cache gambar berbasis snapshot cloud disk data belum tersedia di semua wilayah. Hubungi kami jika Anda memerlukan fitur ini.
    400 DiskVolume.NotSupport The disk volume is not supported. Volume cloud disk tidak didukung. Hubungi kami jika Anda memerlukan fitur ini.
    400 RamRole.NotSupport The RAM role is not supported. Peran instans RAM tidak didukung.
    400 DiskNumber.LimitExceed The maximum number of disks in an instance is exceeded. Jumlah cloud disk yang disambungkan ke instans telah melebihi batas.
    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. Akun Anda tidak memiliki metode pembayaran yang valid. Tambahkan metode pembayaran atau pertahankan saldo pembayaran di muka yang cukup.
    400 DiskVolume.NotInSameZone The instance to be created and the disk are not in the same zone. Instans yang akan dibuat dan cloud disk tidak berada di zona yang sama.
    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. Anda perlu mengajukan permohonan untuk daftar putih konfigurasi CPU tinggi.
    400 RecommendEmpty.InstanceTypeFamilyNotMatched The recommended instance type is unavailable in the current zone. Try again later. Tidak ada tipe instans yang direkomendasikan tersedia di zona saat ini. Coba lagi nanti atau buat instans di zona lain.
    400 LocalDiskAmountNotMatch The number of local volumes does not match the instance type. Jumlah disk lokal tidak cocok dengan tipe instans.
    400 Payfor.CreditPayInsufficientBalance Your payment credit line is insufficient. Batas kredit pembayaran Anda tidak mencukupi.
    400 InvalidOperation.KMS.InstanceTypeNotSupport The specified instance is invalid. Only I/O optimized instances support KMS key. Instans yang ditentukan tidak valid. Hanya instans yang dioptimalkan I/O yang mendukung pengaturan KMS Key.
    400 InvalidParameter.Encrypted.KmsNotEnabled KMS must be enabled for encrypted disks. Cloud disk terenkripsi memerlukan Key Management Service diaktifkan.
    400 InvalidParameter.KMS.EncryptedIllegal After configuring the parameter KmsKeyId, you must enable encryption. Setelah mengatur parameter KmsKeyId, Anda harus mengaktifkan atribut enkripsi.
    400 Ipv6AddressNotSupportVsw IPv6 is not supported in the specified vSwitch. vSwitch tidak memiliki IPv6 yang diaktifkan.
    400 EipAddressPoolIpNotEnough The ip address of specified PublicIpAddressPool is not enough. Kolam alamat publik EIP yang ditentukan tidak memiliki Sumber daya alamat yang cukup.
    400 VnodeDedicatedHostIdAlreadyExist DedicatedHostId:%s of Vnode:%s already exists. DedicatedHostId sudah ada.
    400 DedicatedHostQuotaExceeded The quota of DedicatedHost is exceeded. Kuota untuk host khusus telah terlampaui.
    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. Zona tempat Anda ingin membuat instans tidak lagi tersedia untuk dibeli. Gunakan zona lain, atau vSwitch dari VPC yang ditentukan tidak dapat digunakan di zona ini.
    403 Forbidden.RiskControl This operation has been identified as an abnormal operation and cannot be processed. Operasi ini teridentifikasi sebagai abnormal dan tidak dapat diproses.
    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. Operasi dilarang karena akun memiliki pembayaran tertunda. Isi ulang akun Anda dan coba lagi.
    403 Forbidden.UserNotRealNameAuthentication This operation is not allowed, because you have not passed the real-name verification. Operasi dilarang karena pengguna belum menyelesaikan verifikasi nama asli.
    403 InvalidUser.PassRoleForbidden The RAM user is not authorized to assume a RAM role. Pengguna RAM tidak memiliki izin untuk menggunakan peran instans 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. Anda tidak memiliki izin untuk mengakses KMSKeyId yang ditentukan.
    403 Forbidden.AccountClosed The operation is forbidden. Your account has been closed. Operasi dilarang karena akun pengguna telah dibatalkan.
    403 InvalidOperation.ResourceManagedByCloudProduct The operation is forbidden. The security group has been managed by another cloud product. Grup keamanan dikelola oleh layanan cloud lain dan tidak dapat dimodifikasi.
    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. Risiko keamanan terdeteksi pada kartu kredit atau debit default Anda. Verifikasi kartu Anda menggunakan tautan dalam email.
    403 CreateServiceLinkedRole.Denied Please make sure the account has ram:CreateServiceLinkedRole permission. Pastikan akun memiliki izin ram:CreateServiceLinkedRole.
    404 ImageSnapshot.NotFound The specified snapshot does not exist. Snapshot untuk cache gambar tidak ada.
    404 InvalidDiskId.NotFound The specified disk does not exist. Cloud disk yang ditentukan tidak ada.
    404 InvalidParameter.KMS.KeyId.NotFound The specified KMSKeyId does not exist. KMSKeyId yang ditentukan tidak ada.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.