All Products
Search

This Product

    Elastic Compute Service:CreateLaunchTemplateVersion

    Document Center

    Elastic Compute Service:CreateLaunchTemplateVersion

    Last Updated:Jul 03, 2026

    Membuat versi baru dalam template peluncuran ECS tertentu untuk pembuatan instans ECS, kelompok skalabilitas elastis, atau kelompok penyediaan otomatis berikutnya.

    Deskripsi operasi

    Deskripsi operasi

    Untuk mengubah parameter versi tertentu, buat versi template baru. Setiap template peluncuran instans mendukung maksimum 30 versi.

    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

    ecs:CreateLaunchTemplateVersion

    create

    *LaunchTemplate

    acs:ecs:{#regionId}:{#accountId}:launchtemplate/{#launchtemplateId}

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    Yes

    ID wilayah. Anda dapat memanggil DescribeRegions untuk mengkueri daftar wilayah terbaru.

    cn-hangzhou
    RegionId

    string

    Yes

    ID wilayah. Anda dapat memanggil DescribeRegions untuk mengkueri daftar wilayah terbaru.

    cn-hangzhou
    LaunchTemplateId

    string

    No

    ID template peluncuran. Untuk informasi selengkapnya, panggil DescribeLaunchTemplates. Anda harus menentukan LaunchTemplateId atau LaunchTemplateName untuk menentukan template peluncuran.

    lt-m5eiaupmvm2op9d****
    LaunchTemplateName

    string

    No

    Nama template peluncuran. Nama harus terdiri dari 2 hingga 128 karakter. Nama harus diawali dengan huruf dan tidak boleh diawali dengan http:// atau https://. Nama dapat berisi angka, titik dua (:), garis bawah (_), dan tanda hubung (-).

    testLaunchTemplateName
    VersionDescription

    string

    No

    Deskripsi versi template peluncuran. Deskripsi harus terdiri dari 2 hingga 256 karakter dan tidak boleh diawali dengan http:// atau https://.

    testVersionDescription
    ImageId

    string

    No

    ID image yang digunakan untuk membuat instans. Anda dapat memanggil DescribeImages untuk mengkueri resource image yang tersedia.

    win2008r2_64_ent_sp1_en-us_40G_alibase_20170915.vhd
    ImageOwnerAlias

    string

    No

    Sumber image.

    Catatan

    Parameter ini akan dihentikan. Untuk meningkatkan kompatibilitas, gunakan parameter lain.

    system
    PasswordInherit

    boolean

    No

    Apakah akan menggunakan kata sandi preset image. Nilai valid:

    • true

    • false

    Nilai default: false.

    Catatan

    Saat menggunakan parameter ini, parameter Password harus kosong. Anda juga harus memastikan bahwa image memiliki kata sandi preset.

    false
    InstanceType

    string

    No

    Tipe instans. Untuk informasi selengkapnya, lihat Keluarga instans. Anda juga dapat memanggil DescribeInstanceTypes untuk mengkueri daftar tipe instans terbaru.

    ecs.g5.large
    SecurityGroupId

    string

    No

    ID grup keamanan tempat instans yang dibuat menggunakan versi ini berada. Instans dalam grup keamanan yang sama dapat saling berkomunikasi.

    Catatan

    Anda tidak dapat menentukan SecurityGroupId dan SecurityGroupIds.N secara bersamaan.

    sg-bp15ed6xe1yxeycg****
    VpcId

    string

    No

    ID virtual private cloud (VPC) tempat instans berada.

    vpc-bp12433upq1y5scen****
    VSwitchId

    string

    No

    ID vSwitch. Anda harus menentukan parameter ini saat membuat instans yang terhubung ke VPC.

    vsw-bp1s5fnvk4gn2tws0****
    InstanceName

    string

    No

    Nama instans. Nama harus terdiri dari 2 hingga 128 karakter dan dapat berisi huruf, angka, serta karakter dari kategori huruf Unicode (termasuk karakter dari berbagai bahasa). Nama dapat berisi titik dua (:), garis bawah (_), titik (.), dan tanda hubung (-). Nilai default adalah InstanceId instans.

    Saat membuat beberapa instans ECS sekaligus, Anda dapat mengonfigurasi nama instans berurutan secara batch yang berisi tanda kurung ([]) dan koma (,). Untuk informasi selengkapnya, lihat Mengonfigurasi nama atau hostname berurutan secara batch untuk beberapa instans.

    k8s-node-[1,4]-alibabacloud
    Description

    string

    No

    Deskripsi instans. Deskripsi harus terdiri dari 2 hingga 256 karakter dan tidak boleh diawali dengan http:// atau https://.

    testDescription
    InternetMaxBandwidthIn

    integer

    No

    Bandwidth publik arah masuk maksimum. Unit: Mbit/s. Nilai valid:

    • Jika bandwidth publik arah keluar yang dibeli kurang dari atau sama dengan 10 Mbit/s: 1 hingga 10. Nilai default: 10.

    • Jika bandwidth publik arah keluar yang dibeli lebih dari 10 Mbit/s: 1 hingga nilai InternetMaxBandwidthOut. Nilai default: nilai InternetMaxBandwidthOut.

    50
    InternetMaxBandwidthOut

    integer

    No

    Bandwidth publik arah keluar maksimum. Unit: Mbit/s. Nilai valid: 0 hingga 100.

    5
    HostName

    string

    No

    Hostname server Elastic Compute Service (ECS).

    • Hostname tidak boleh diawali atau diakhiri dengan titik (.) atau tanda hubung (-), dan tidak boleh mengandung titik atau tanda hubung berurutan.

    • Instans Windows: Hostname harus terdiri dari 2 hingga 15 karakter dan tidak boleh mengandung titik (.) atau terdiri seluruhnya dari angka. Hostname dapat berisi huruf, angka, dan tanda hubung (-).

    • Instans lainnya (seperti Linux): Hostname harus terdiri dari 2 hingga 64 karakter. Hostname dapat mengandung beberapa titik (.), dengan setiap segmen di antara titik memperbolehkan huruf, angka, dan tanda hubung (-).

    testHostName
    ZoneId

    string

    No

    ID zona instans.

    cn-hangzhou-g
    SystemDisk.Category

    string

    No

    Kategori disk sistem. Nilai valid:

    • cloud: disk dasar.

    • cloud_efficiency: disk ultra.

    • cloud_ssd: SSD standar.

    • cloud_auto: disk ESSD AutoPL.

    • cloud_essd: SSD Perusahaan (ESSD). Anda dapat menggunakan parameter SystemDisk.PerformanceLevel untuk mengonfigurasi tingkat kinerja disk.

    • cloud_essd_entry: disk ESSD Entry.

    Untuk tipe instans yang sudah dihentikan yang bukan merupakan instans yang dioptimalkan untuk I/O, nilai defaultnya adalah cloud. Untuk tipe instans lainnya, nilai defaultnya adalah cloud_efficiency.

    cloud_ssd
    SystemDisk.Size

    integer

    No

    Ukuran disk sistem. Unit: GiB. Nilai valid:

    • cloud: 20 hingga 500.

    • Kategori disk lainnya: 20 hingga 2048.

    Nilai parameter ini harus lebih besar dari atau sama dengan max{20, ImageSize}.

    40
    SystemDisk.DiskName

    string

    No

    Nama disk sistem. Nama harus terdiri dari 2 hingga 128 karakter. Nama harus diawali dengan huruf dan tidak boleh diawali dengan http:// atau https://. Nama dapat berisi angka, titik dua (:), garis bawah (_), dan tanda hubung (-).

    cloud_ssdSystem
    SystemDisk.Description

    string

    No

    Deskripsi disk sistem. Deskripsi harus terdiri dari 2 hingga 256 karakter dan tidak boleh diawali dengan http:// atau https://.

    testSystemDiskDescription
    SystemDisk.Iops

    integer

    No

    Catatan

    Parameter ini tidak tersedia untuk umum.

    30000
    SystemDisk.PerformanceLevel

    string

    No

    Tingkat kinerja ESSD yang digunakan sebagai disk sistem. Konfigurasikan tingkat kinerja berdasarkan nilai valid berikut:

    • PL0 (default): Satu disk dapat memberikan hingga 10.000 IOPS baca/tulis acak.

    • PL1: Satu disk dapat memberikan hingga 50.000 IOPS baca/tulis acak.

    • PL2: Satu disk dapat memberikan hingga 100.000 IOPS baca/tulis acak.

    • PL3: Satu disk dapat memberikan hingga 1.000.000 IOPS baca/tulis acak.

    Untuk informasi tentang cara memilih tingkat kinerja ESSD, lihat ESSD.

    PL0
    SystemDisk.DeleteWithInstance

    boolean

    No

    Apakah akan merilis disk sistem saat instans dirilis. Nilai valid:

    • true: merilis disk sistem saat instans dirilis.

    • false: tidak merilis disk sistem saat instans dirilis.

    Nilai default: true.

    true
    SystemDisk.AutoSnapshotPolicyId

    string

    No

    ID kebijakan snapshot otomatis yang diterapkan pada disk sistem.

    sp-bp1dgzpaxwc4load****
    SystemDisk.ProvisionedIops

    integer

    No

    IOPS baca/tulis yang disediakan dari disk ESSD AutoPL yang digunakan sebagai disk sistem. Nilai valid: 0 hingga min{50000, 1000 × Kapasitas - Kinerja Dasar}.

    Kinerja Dasar = min{1.800 + 50 × Kapasitas, 50.000}.

    Catatan

    Parameter ini hanya tersedia saat DiskCategory diatur ke cloud_auto. Untuk informasi selengkapnya, lihat Disk ESSD AutoPL dan Mengubah performa yang disediakan dari disk ESSD AutoPL.

    50000
    SystemDisk.BurstingEnabled

    boolean

    No

    Apakah akan mengaktifkan fitur lonjakan performa. Nilai valid:

    • true: mengaktifkan fitur lonjakan performa.

    • false: tidak mengaktifkan fitur lonjakan performa.

    true
    IoOptimized

    string

    No

    Apakah instans merupakan instans yang dioptimalkan untuk I/O. Nilai valid:

    • none: Instans tidak dioptimalkan untuk I/O.

    • optimized: Instans diaktifkan untuk optimasi I/O.

    optimized
    InstanceChargeType

    string

    No

    Metode penagihan instans. Nilai valid:

    • PrePaid: langganan. Jika Anda mengatur parameter ini ke PrePaid, pastikan akun Anda mendukung pembayaran kredit. Jika tidak, kesalahan InvalidPayMethod akan dikembalikan.

    • PostPaid: bayar sesuai penggunaan.

    PrePaid
    Period

    integer

    No

    Durasi langganan resource. Unit: bulan. Parameter ini berlaku dan wajib diisi hanya saat InstanceChargeType diatur ke PrePaid. Nilai valid: 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36, 48, dan 60.

    1
    InternetChargeType

    string

    No

    Metode penagihan untuk bandwidth Internet arah keluar. Nilai valid:

    • PayByBandwidth: bayar berdasarkan bandwidth.

    • PayByTraffic: bayar berdasarkan trafik.

    Catatan

    Dalam mode bayar berdasarkan trafik, puncak bandwidth arah masuk dan arah keluar digunakan sebagai batas atas bandwidth, bukan sebagai spesifikasi kinerja yang dijamin. Saat terjadi konflik sumber daya, puncak bandwidth dapat dibatasi. Jika Anda menginginkan bandwidth yang dijamin, gunakan mode bayar berdasarkan bandwidth.

    PayByTraffic
    EnableVmOsConfig

    boolean

    No

    Apakah akan mengaktifkan konfigurasi sistem operasi instans.

    false
    NetworkType

    string

    No

    Jenis jaringan instans. Nilai valid:

    • vpc: VPC.

    • classic: jaringan klasik. Jaringan klasik telah dihentikan. Untuk informasi selengkapnya, lihat Pemberitahuan penghentian.

    vpc
    UserData

    string

    No

    Data pengguna instans. Data pengguna instans harus dienkode dalam Base64. Data mentah dapat berukuran hingga 32 KB.

    ZWNobyBoZWxsbyBl****
    KeyPairName

    string

    No

    Nama pasangan kunci.

    • Untuk instans Windows, parameter ini diabaikan. Meskipun Anda menentukan parameter ini, hanya konten Password yang digunakan.

    • Untuk instans Linux, logon berbasis kata sandi dinonaktifkan selama inisialisasi.

    testKeyPairName
    RamRoleName

    string

    No

    Nama Peran RAM instans. Anda dapat memanggil API RAM ListRoles untuk mengkueri Peran RAM instans yang telah Anda buat.

    testRamRoleName
    AutoReleaseTime

    string

    No

    Waktu pelepasan otomatis. Tentukan waktu dalam format standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam UTC.

    • Jika nilai detik (ss) bukan 00, waktu secara otomatis dibulatkan ke awal menit saat ini (mm).

    • Waktu rilis paling awal adalah 30 menit setelah waktu saat ini.

    • Waktu rilis paling akhir tidak boleh lebih dari tiga tahun dari waktu saat ini.

    2018-01-01T12:05:00Z
    SpotStrategy

    string

    No

    Kebijakan preemsi untuk instans bayar sesuai penggunaan. Parameter ini berlaku saat InstanceChargeType diatur ke PostPaid. Nilai valid:

    • NoSpot: Instans adalah instans bayar sesuai penggunaan biasa.

    • SpotWithPriceLimit: Instans adalah spot instans dengan harga per jam maksimum yang ditentukan pengguna.

    • SpotAsPriceGo: Instans adalah spot instans yang secara otomatis menggunakan harga pasar pada saat pembelian sebagai harga penawaran.

    NoSpot
    SpotPriceLimit

    number

    No

    Harga per jam maksimum instans. Maksimum tiga angka desimal didukung.

    0.97
    SpotDuration

    integer

    No

    Periode perlindungan spot instans. Unit: jam. Nilai default: 1. Nilai valid:

    • 1: Setelah spot instans dibuat, Alibaba Cloud memastikan bahwa instans tidak dirilis secara otomatis (pelepasan otomatis) dalam 1 jam. Setelah periode perlindungan 1 jam berakhir, sistem membandingkan harga penawaran dengan harga pasar dan memeriksa inventaris resource untuk menentukan apakah akan mempertahankan atau melakukan pelepasan otomatis instans.

    • 0: Setelah spot instans dibuat, Alibaba Cloud tidak memastikan bahwa instans berjalan selama 1 jam. Sistem membandingkan harga penawaran dengan harga pasar dan memeriksa inventaris resource untuk menentukan apakah akan mempertahankan atau melakukan pelepasan otomatis instans.

    Alibaba Cloud mengirimkan notifikasi event sistem ECS 5 menit sebelum instans dirilis. Spot instans ditagih per detik. Kami menyarankan Anda memilih periode perlindungan yang sesuai berdasarkan perkiraan durasi eksekusi tugas.

    Catatan

    Parameter ini hanya berlaku saat SpotStrategy diatur ke SpotWithPriceLimit atau SpotAsPriceGo.

    1
    ResourceGroupId

    string

    No

    ID kelompok sumber daya.

    rg-bp67acfmxazb4p****
    SecurityEnhancementStrategy

    string

    No

    Apakah akan mengaktifkan Penguatan Keamanan untuk sistem operasi. Nilai valid:

    • Active: mengaktifkan Penguatan Keamanan. Nilai ini hanya berlaku untuk image publik.

    • Deactive: tidak mengaktifkan Penguatan Keamanan. Nilai ini berlaku untuk semua tipe image.

    Active
    PrivateIpAddress

    string

    No

    Alamat IP privat instans.

    Saat Anda menentukan alamat IP privat untuk instans ECS yang terhubung ke VPC, alamat IP harus berasal dari Blok CIDR yang tidak terpakai dari vSwitch (VSwitchId).

    10.1.**.**
    Ipv6AddressCount

    integer

    No

    Jumlah alamat IPv6 yang akan dibuat secara acak untuk ENI primer. Nilai valid: 1 hingga 10.

    1
    DeploymentSetId

    string

    No

    ID set penyebaran.

    ds-bp1brhwhoqinyjd6****
    DataDisk

    array<object>

    No

    Daftar disk data.

    object

    No

    Daftar disk data.

    PerformanceLevel

    string

    No

    Tingkat kinerja ESSD yang digunakan sebagai disk data. Nilai N harus sama dengan nilai dalam DataDisk.N.Category=cloud_essd. Konfigurasikan tingkat kinerja berdasarkan nilai valid berikut:

    • PL0: Satu disk dapat memberikan hingga 10.000 IOPS baca/tulis acak.

    • PL1 (default): Satu disk dapat memberikan hingga 50.000 IOPS baca/tulis acak.

    • PL2: Satu disk dapat memberikan hingga 100.000 IOPS baca/tulis acak.

    • PL3: Satu disk dapat memberikan hingga 1.000.000 IOPS baca/tulis acak.

    Untuk informasi tentang cara memilih tingkat kinerja ESSD, lihat ESSD.

    PL1
    Description

    string

    No

    Deskripsi disk data. Deskripsi harus terdiri dari 2 hingga 256 karakter dan tidak boleh diawali dengan http:// atau https://.

    testDataDiskDescription
    SnapshotId

    string

    No

    ID snapshot yang digunakan untuk membuat disk data N. Nilai valid N: 1 hingga 16. Saat DataDisk.N.SnapshotId ditentukan, DataDisk.N.Size diabaikan. Ukuran aktual disk yang dibuat adalah ukuran snapshot yang ditentukan.

    Snapshot yang dibuat pada atau sebelum 15 Juli 2013 tidak dapat digunakan. Permintaan yang menggunakan snapshot tersebut akan ditolak.

    s-bp17441ohwka0yuh****
    Size

    integer

    No

    Ukuran disk data N. Nilai valid N: 1 hingga 16. Unit: GiB. Nilai valid:

    • cloud: 5 hingga 2000.

    • cloud_efficiency: 20 hingga 32768.

    • cloud_ssd: 20 hingga 32768.

    • cloud_essd: Rentang nilai valid bergantung pada nilai DataDisk.N.PerformanceLevel.

      • PL0: 1 hingga 32768.

      • PL1: 20 hingga 32768.

      • PL2: 461 hingga 32768.

      • PL3: 1261 hingga 32768.

    • cloud_auto: 1 hingga 32.768.

    • cloud_essd_entry: 10 hingga 32.768.

    Nilai parameter ini harus lebih besar dari atau sama dengan ukuran snapshot yang ditentukan oleh SnapshotId.

    2000
    Device

    string

    No

    Titik pemasangan disk data. Konvensi penamaan titik pemasangan bervariasi berdasarkan jumlah disk data yang dipasang:

    • 1 hingga 25 disk data: /dev/xvd[b-z]

    • Lebih dari 25 disk data: /dev/xvd[aa-zz]. Misalnya, disk data ke-26 diberi nama /dev/xvdaa, disk data ke-27 diberi nama /dev/xvdab, dan seterusnya.

    Catatan

    Parameter ini hanya berlaku untuk skenario image penuh (image sistem). Anda dapat mengatur parameter ini ke titik pemasangan disk data dalam image penuh dan mengubah parameter DataDisk.N.Size dan DataDisk.N.Category yang sesuai untuk mengubah kategori dan ukuran disk data dalam image penuh.

    /dev/xvdb

    DiskName

    string

    No

    Nama disk data. Nama harus terdiri dari 2 hingga 128 karakter. Nama harus diawali dengan huruf dan tidak boleh diawali dengan http:// atau https://. Nama dapat berisi angka, titik dua (:), garis bawah (_), dan tanda hubung (-).

    testDataDiskName
    Category

    string

    No

    Kategori disk data N. Nilai valid:

    • cloud_efficiency: disk ultra.

    • cloud_ssd: SSD standar.

    • cloud_essd: SSD Perusahaan (ESSD).

    • cloud: disk dasar.

    • cloud_auto: disk ESSD AutoPL.

    • cloud_regional_disk_auto: ESSD regional.

    • cloud_essd_entry: disk ESSD Entry.
      Catatan

      Nilai cloud_essd_entry hanya didukung saat InstanceType dikonfigurasi sebagai tipe instans dalam family ecs.u1 atau ecs.e.

    • elastic_ephemeral_disk_standard: disk ephemeral elastis - Jenis Penyimpanan Standar.

    • elastic_ephemeral_disk_premium: disk ephemeral elastis - Edisi Premium.

    Untuk instans yang dioptimalkan untuk I/O, nilai defaultnya adalah cloud_efficiency. Untuk instans yang tidak dioptimalkan untuk I/O, nilai defaultnya adalah cloud. Detail nilai default:

    • Saat InstanceType diatur ke tipe instans yang sudah dihentikan yang tidak dioptimalkan untuk I/O, nilai parameter default adalah cloud.

    • Dalam kasus lain, nilai defaultnya adalah cloud_efficiency.

    cloud_ssd
    DeleteWithInstance

    boolean

    No

    Apakah akan merilis disk data saat instans dirilis. Nilai valid:

    • true: merilis disk data saat instans dirilis.

    • false: tidak merilis disk data saat instans dirilis.

    Nilai default: true.

    true
    Encrypted

    string

    No

    Apakah akan mengenkripsi disk data.

    false
    ProvisionedIops

    integer

    No

    IOPS baca/tulis yang disediakan dari disk ESSD AutoPL yang digunakan sebagai disk sistem. Nilai valid: 0 hingga min{50000, 1000 × Kapasitas - Kinerja Dasar}.

    Kinerja Dasar = min{1.800 + 50 × Kapasitas, 50.000}.

    Catatan

    Parameter ini hanya tersedia saat DiskCategory diatur ke cloud_auto. Untuk informasi selengkapnya, lihat Disk ESSD AutoPL dan Mengubah performa yang disediakan dari disk ESSD AutoPL.

    50000
    BurstingEnabled

    boolean

    No

    Apakah akan mengaktifkan fitur lonjakan performa. Nilai valid:

    • true: mengaktifkan fitur lonjakan performa.

    • false: tidak mengaktifkan fitur lonjakan performa.

    true
    AutoSnapshotPolicyId

    string

    No

    ID kebijakan snapshot otomatis yang diterapkan pada disk data.

    sp-bp67acfmxazb4p****
    KMSKeyId

    string

    No

    ID kunci KMS untuk disk data.

    0e478b7a-4262-4802-b8cb-00d****
    NetworkInterface

    array<object>

    No

    Informasi antarmuka jaringan (NIC).

    object

    No

    Informasi antarmuka jaringan (NIC).

    VSwitchId

    string

    No

    ID vSwitch tempat antarmuka jaringan (NIC) sekunder berada. Instans dan NIC sekunder harus berada dalam VPC dan zona aktif yang sama, tetapi dapat berada di vSwitch yang berbeda. Nilai N dalam NetworkInterface.N tidak boleh lebih dari 1.

    vsw-bp1s5fnvk4gn2tws0****
    NetworkInterfaceName

    string

    No

    Nama antarmuka jaringan (NIC) sekunder. Nilai N dalam NetworkInterface.N tidak boleh lebih dari 1.

    testNetworkInterfaceName
    Description

    string

    No

    Deskripsi antarmuka jaringan (NIC) sekunder. Deskripsi harus terdiri dari 2 hingga 256 karakter dan tidak boleh diawali dengan http:// atau https://. Nilai N dalam NetworkInterface.N tidak boleh lebih dari 1.

    testNetworkInterfaceDescription
    SecurityGroupId

    string

    No

    ID grup keamanan tempat antarmuka jaringan (NIC) sekunder berada. Grup keamanan NIC sekunder harus berada dalam VPC yang sama dengan instans. Nilai N dalam NetworkInterface.N tidak boleh lebih dari 1.

    Catatan

    Anda tidak dapat menentukan NetworkInterface.N.SecurityGroupId dan NetworkInterface.N.SecurityGroupIds.N secara bersamaan.

    sg-bp15ed6xe1yxeycg****
    PrimaryIpAddress

    string

    No

    Alamat IP privat primer dari antarmuka jaringan (NIC) sekunder. Nilai N dalam NetworkInterface.N tidak boleh lebih dari 1.

    192.168.**.**
    SecurityGroupIds

    array

    No

    ID satu atau beberapa grup keamanan tempat antarmuka jaringan (NIC) sekunder berada. Grup keamanan dan NIC sekunder harus berada dalam VPC yang sama. Nilai valid N dalam SecurityGroupIds.N bergantung pada kuota jumlah maksimum grup keamanan yang dapat dimiliki oleh NIC sekunder. Untuk informasi selengkapnya, lihat Batas. Nilai N dalam NetworkInterface.N tidak boleh lebih dari 1.

    Catatan

    Anda tidak dapat menentukan NetworkInterface.N.SecurityGroupId dan NetworkInterface.N.SecurityGroupIds.N secara bersamaan.

    sg-bp67acfmxazb4p****

    string

    No

    ID satu atau beberapa grup keamanan tempat antarmuka jaringan (NIC) sekunder berada. Grup keamanan dan NIC sekunder harus berada dalam VPC yang sama. Nilai valid N dalam SecurityGroupIds.N bergantung pada kuota jumlah maksimum grup keamanan yang dapat dimiliki oleh NIC sekunder. Untuk informasi selengkapnya, lihat Batas. Nilai N dalam NetworkInterface.N tidak boleh lebih dari 1.

    Catatan

    Anda tidak dapat menentukan NetworkInterface.N.SecurityGroupId dan NetworkInterface.N.SecurityGroupIds.N secara bersamaan.

    sg-bp67acfmxazb4p****
    InstanceType

    string

    No

    Tipe antarmuka jaringan (ENI). Nilai valid N: 1 hingga 2. Jika Anda mengonfigurasi satu ENI, Anda dapat mengonfigurasi ENI primer atau ENI sekunder. Jika Anda mengonfigurasi dua ENI, Anda harus mengonfigurasi satu NIC primer dan satu ENI sekunder.

    Nilai valid:

    • Primary: NIC primer.

    • Secondary: ENI sekunder.

    Nilai default: Secondary.

    Secondary
    NetworkInterfaceTrafficMode

    string

    No

    Mode komunikasi ENI primer. Nilai valid:

    • Standard: menggunakan mode komunikasi TCP.

    • HighPerformance: mengaktifkan Elastis RDMA Interface (ERI) dan menggunakan mode komunikasi RDMA.

    Standard
    DeleteOnRelease

    boolean

    No

    Apakah akan mempertahankan ENI saat instans dirilis. Nilai valid:

    • true: tidak mempertahankan ENI.

    • false: mempertahankan ENI.

    Nilai default: true.

    Catatan

    Parameter ini hanya berlaku untuk ENI sekunder.

    true
    Tag

    array<object>

    No

    Tag instans, disk, dan ENI primer yang dibuat menggunakan versi ini.

    object

    No

    Tag instans, disk, dan ENI primer yang dibuat menggunakan versi ini.

    Key

    string

    No

    Kunci tag instans, disk, dan ENI primer yang dibuat menggunakan versi ini. Nilai valid N: 1 hingga 20. Kunci tag tidak boleh berupa string kosong. Panjangnya dapat mencapai 128 karakter dan tidak boleh diawali dengan aliyun atau acs:. Tidak boleh mengandung http:// atau https://.

    TestKey
    Value

    string

    No

    Nilai tag instans, disk, dan ENI primer yang dibuat menggunakan versi ini. Nilai valid N: 1 hingga 20. Nilai tag dapat berupa string kosong. Panjangnya dapat mencapai 128 karakter dan tidak boleh mengandung http:// atau https://.

    TestValue
    SecurityGroupIds

    array

    No

    ID satu atau beberapa grup keamanan tempat instans berada. Nilai valid N bergantung pada jumlah maksimum grup keamanan yang dapat dimiliki oleh instans. Untuk informasi selengkapnya, lihat Batas.

    Catatan

    Anda tidak dapat menentukan SecurityGroupId dan SecurityGroupIds.N secara bersamaan.

    sg-bp15ed6xe1yxeycg7****

    string

    No

    ID satu atau beberapa grup keamanan tempat instans berada. Nilai valid N bergantung pada jumlah maksimum grup keamanan yang dapat d.

    sg-bp15ed6xe1yxeycg7****
    SystemDisk.Encrypted

    string

    No

    Apakah akan mengenkripsi disk sistem. Nilai valid:

    • true: mengenkripsi disk sistem.

    • false: tidak mengenkripsi disk sistem.

    Nilai default: false.

    Catatan

    Enkripsi disk sistem tidak didukung di Zona D wilayah Hong Kong (Tiongkok) atau Zona A wilayah Singapura saat membuat instans.

    false
    DeletionProtection

    boolean

    No

    Atribut perlindungan pelepasan instans. Apakah instans dapat dirilis dari Konsol atau dengan memanggil DeleteInstance. Nilai valid:

    • true: mengaktifkan perlindungan pelepasan.

    • false: menonaktifkan perlindungan pelepasan.

    Nilai default: false.

    Catatan

    Atribut ini hanya berlaku untuk instans bayar sesuai penggunaan. Atribut ini hanya membatasi operasi pelepasan manual dan tidak berlaku untuk operasi pelepasan yang diprakarsai sistem.

    false
    CreditSpecification

    string

    No

    Mode berjalan instans burstable. Nilai valid:

    • Standard: mode standar. Untuk informasi selengkapnya, lihat bagian mode terbatas kinerja dalam Ikhtisar instans burstable.

    • Unlimited: mode tanpa batas.

    Standard
    AutoRenew

    boolean

    No

    Apakah akan mengaktifkan perpanjangan otomatis. Parameter ini hanya berlaku saat InstanceChargeType diatur ke PrePaid. Nilai valid:

    • true: mengaktifkan perpanjangan otomatis.

    • false: tidak mengaktifkan perpanjangan otomatis.

    Nilai default: false.

    true
    AutoRenewPeriod

    integer

    No

    Periode perpanjangan otomatis. Nilai valid:

    Jika PeriodUnit diatur ke Month: 1, 2, 3, 6, 12, 24, 36, 48, dan 60.

    Nilai default: 1.

    1
    PeriodUnit

    string

    No

    Unit durasi langganan. Nilai valid:

    Month (default). [_single.params

    Month
    HttpEndpoint

    string

    No

    Specifies whether to enable the access channel for instance metadata. Valid values:

    • enabled: enables the access channel.

    • disabled: disables the access channel.

    Default value: enabled.

    Catatan

    For more information about instance metadata, see Overview of ECS instance metadata.

    enabled
    HttpTokens

    string

    No

    Specifies whether to forcefully use the security-hardened mode (IMDSv2) to access instance metadata. Valid values:

    • optional: does not forcefully use the security-hardened mode.

    • required: forcefully uses the security-hardened mode. After you set this value, the normal mode cannot be used to access instance metadata.

    Default value: optional.

    Catatan

    For more information about the modes for accessing instance metadata, see Overview of ECS instance metadata.

    optional
    HttpPutResponseHopLimit

    integer

    No

    Catatan

    Parameter ini tidak tersedia untuk umum.

    3
    SystemDisk.KMSKeyId

    string

    No

    The KMS key ID of the system disk.

    0e478b7a-4262-4802-b8cb-00d3fb40****
    ImageOptions

    object

    No

    The image-related property information.

    LoginAsNonRoot

    boolean

    No

    Specifies whether instances that use this image support logon with the ecs-user user. Valid values:

    • true: supported.

    • false: not supported.

    false
    SecurityOptions

    object

    No

    The security options.

    TrustedSystemMode

    string

    No

    The trusted system mode. Set the value to vTPM.

    The following instance families support trusted system mode:

    • g7, c7, and r7.

    • Security-enhanced instance family (g7t, c7t, and r7t).

    When you create ECS instances of the preceding instance families, you must configure this parameter. Details:

    • To use the Alibaba Cloud Trusted System, set this parameter to vTPM. The trusted verification is completed by the Alibaba Cloud Trusted System when the instance starts.

    • If you do not use the Alibaba Cloud Trusted System, you can leave this parameter empty. However, if the ECS instance that you create uses the Enclave-based confidential computing mode (SecurityOptions.ConfidentialComputingMode=Enclave), the trusted system is also enabled for the instance.

    • When you create a trusted ECS instance by invoking an API operation, you can only invoke RunInstances. CreateInstance does not support configuring the SecurityOptions.TrustedSystemMode parameter.

    Catatan

    If you specify an instance as a trusted instance during creation, you can only use images that support the trusted system when you replace the system disk.

    For more information about the trusted system, see Overview of trusted features for security-enhanced instances.

    vTPM

    Elemen respons

    Element

    Type

    Description

    Example

    object

    LaunchTemplateVersionNumber

    integer

    The version number of the launch template that is created.

    2
    RequestId

    string

    ID permintaan.

    473469C7-AA6F-4DC5-B3DB-A3DC0DEX****
    LaunchTemplateId

    string

    The ID of the launch template. For more information, see DescribeLaunchTemplates.

    When you use a launch template to create an instance, you must specify LaunchTemplateId or LaunchTemplateName to determine the launch template.

    lt-bp1apo0bbbkuy0rj****

    Contoh

    Respons sukses

    JSONformat

    {
  "LaunchTemplateVersionNumber": 2,
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DEX****",
  "LaunchTemplateId": "lt-bp1apo0bbbkuy0rj****"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 InvalidRegion.NotExist %s
    400 MissingParameter %s
    400 InvalidParameter %s
    400 InvalidDescription.Malformed The specified parameter "Description" is not valid.
    400 InvalidUserData.SizeExceeded %s
    400 InvalidUserData.Base64FormatInvalid %s
    400 InvalidHostName.Malformed The specified parameter "HostName" is not valid.
    400 InvalidParams.CreateEniParams %s
    400 Duplicate.TagKey The Tag.N.Key contain duplicate key.
    500 InternalError The request processing has failed due to some unknown error.
    403 LaunchTemplateVersionLimitExceed %s
    404 InvalidLaunchTemplate.NotFound %s
    404 InvalidResourceGroup.NotFound The ResourceGroup provided does not exist in our records.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.