全部产品
Search

搜索本产品

    Elastic Container Instance：CreateVirtualNode

    文档中心

    Elastic Container Instance：CreateVirtualNode

    更新时间：Dec 15, 2025

    Membuat virtual node untuk menghubungkan kluster Kubernetes yang dikelola sendiri ke Elastic Container Instance (ECI) dan melakukan penskalaan sumber daya.

    Deskripsi operasi

    • Saat Anda memanggil operasi ini untuk membuat virtual node, sistem secara otomatis membuat peran terkait layanan bernama AliyunServiceRoleForECIVnode. Peran ini memberikan akses ke layanan Alibaba Cloud terkait, seperti ECI, Elastic Compute Service (ECS), dan VPC. Untuk informasi selengkapnya, lihat Peran terkait layanan untuk virtual node.

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

    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 di dalam virtual node tersebut ditambahkan ke security group ini.

    sg-2ze81zoc3yl7a3we****
    VSwitchId

    string

    Yes

    ID vSwitch yang digunakan oleh virtual node dan instans ECI pada virtual node tersebut.
    Anda dapat menentukan 1 hingga 10 vSwitch yang berada 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 (.), serta tanda hubung (-).

    testNode
    ResourceGroupId

    string

    No

    ID kelompok sumber daya.

    rg-uf66jeqopgqa9hdn****
    ClientToken

    string

    No

    Memastikan idempotensi permintaan. Klien menghasilkan nilai untuk parameter ini. Anda harus memastikan bahwa nilainya unik untuk setiap permintaan. Nilai hanya boleh berisi karakter ASCII dan tidak boleh lebih dari 64 karakter. Untuk informasi selengkapnya, lihat Cara memastikan idempotensi.

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

    boolean

    No

    Menentukan apakah akses internet diaktifkan. Nilai default adalah false.
    Jika diatur ke true, virtual node akan diberi Alamat IP publik.

    false
    EipInstanceId

    string

    No

    ID Elastic IP Address.

    eip-uf66jeqopgqa9hdn****
    KubeConfig

    string

    No

    KubeConfig dari kluster Kubernetes yang terhubung ke virtual node. Nilainya harus dikodekan dalam Base64.

    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 virtual node. Formatnya adalah nama resource=jumlah resource. Gunakan koma untuk memisahkan beberapa resource.

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

    string

    No

    Nama domain kluster. Setelah dikonfigurasi, 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 pada Pod ECI, Pod tersebut menggunakan alamat-alamat ini untuk DNS. Anda dapat menentukan beberapa alamat IP. Pisahkan dengan koma.

    100.1.XX.XX
    Tag

    array<object>

    No

    Tag untuk virtual node. Anda dapat menentukan maksimal 20 tag.

    object

    No

    Taint yang diterapkan pada virtual node.

    Key

    string

    No

    Kunci tag.

    name
    Value

    string

    No

    Nilai tag.

    test
    Taint

    array<object>

    No

    Anda dapat menambahkan hingga 20 tag ke virtual node.

    object

    No

    Tag yang diterapkan pada virtual node.

    Key

    string

    No

    Kunci tag.

    testKey
    Value

    string

    No

    Nilai tag.

    testValue
    Effect

    string

    No

    Efek taint. Nilai yang valid: \- NoSchedule: Pod tidak dapat dijadwalkan ke node yang memiliki taint. \- NoExecute: Pod tidak dapat dijadwalkan ke node yang memiliki taint, dan Pod yang sudah ada di node tersebut akan diusir. \- PreferNoSchedule: Pod sebaiknya tidak dijadwalkan ke node yang memiliki taint.

    NoSchedule
    TlsBootstrapEnabled

    boolean

    No

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

    • true: Diaktifkan

    • false: Dinonaktifkan

    Default: false.

    false

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Tanggapan.

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