All Products
Search

This Product

    Elastic Compute Service:CreateLaunchTemplate

    Document Center

    Elastic Compute Service:CreateLaunchTemplate

    Last Updated:Sep 17, 2026

    Membuat template peluncuran instans ECS. Template peluncuran menghilangkan kebutuhan untuk mengonfigurasi parameter dalam jumlah besar setiap kali Anda membuat instans.

    Deskripsi operasi

    Setelah Anda memanggil CreateLaunchTemplate untuk membuat template, versi default dengan nomor versi 1 akan dibuat secara otomatis. Anda kemudian dapat membuat beberapa versi berdasarkan template ini (CreateLaunchTemplateVersion), dengan nomor versi bertambah secara berurutan dari 1. Jika Anda tidak menentukan versi template saat membuat instans (RunInstances), versi default akan digunakan.

    Versi template peluncuran berisi konfigurasi yang digunakan untuk membuat instans, seperti wilayah, ID image, tipe instans, ID grup keamanan, dan bandwidth publik. Jika konfigurasi instans tertentu tidak ditentukan dalam versi tersebut, Anda harus menentukannya saat membuat instans.

    Saat Anda memanggil operasi ini, perhatikan hal-hal berikut:

    • Setiap akun dapat membuat hingga 30 template peluncuran per wilayah, dan setiap template dapat memiliki hingga 30 versi.

    • Sebagian besar parameter dalam template peluncuran bersifat opsional. Saat Anda membuat template, Alibaba Cloud tidak memverifikasi keberadaan atau validitas nilai parameter. Validitas nilai parameter hanya diverifikasi saat Anda benar-benar membuat instans.

    • Jika konfigurasi tertentu ditetapkan dalam template peluncuran, konfigurasi tersebut tidak dapat diabaikan saat Anda membuat instans (RunInstances). Misalnya, jika template menetapkan HostName=LocalHost dan nilai HostName dibiarkan kosong di RunInstances, hostname instans tetap LocalHost. Untuk menimpa konfigurasi HostName=LocalHost, tetapkan HostName=MyHost atau nilai lain di RunInstances.

    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:CreateLaunchTemplate

    create

    *LaunchTemplate.

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

    		 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
    TemplateTag

    array<object>

    No

    Informasi tag dari template peluncuran itu sendiri.

    Catatan

    Saat ini, Anda hanya dapat membuat dan mengkueri tag untuk template peluncuran dengan memanggil operasi API. Anda tidak dapat membuat atau melihat tag ini di konsol.

    object

    No

    Pasangan kunci tag dan nilai tag dari template peluncuran itu sendiri.

    Key

    string

    No

    Kunci tag dari template peluncuran. Nilai valid N: 1 hingga 20. Kunci tag tidak boleh berupa string kosong. Panjang kunci tag dapat mencapai 128 karakter dan tidak boleh diawali dengan aliyun atau acs:. Kunci tag tidak boleh mengandung http:// atau https://.

    TestKey
    Value

    string

    No

    Nilai tag dari template peluncuran. Nilai valid N: 1 hingga 20. Nilai tag dapat berupa string kosong. Panjang nilai tag dapat mencapai 128 karakter dan tidak boleh diawali dengan aliyun atau acs:. Nilai tag tidak boleh mengandung http:// atau https://.

    TestValue
    RegionId

    string

    Yes

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

    testLaunchTemplateName
    LaunchTemplateName

    string

    Yes

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

    testVersionDescription
    VersionDescription

    string

    No

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

    win2008r2_64_ent_sp1_en-us_40G_alibase_20170915.vhd
    ImageId

    string

    No

    Sumber image. Nilai valid:

    • system: image publik yang disediakan oleh Alibaba Cloud.

    • self: image kustom yang Anda buat.

    • others: image bersama dari akun Alibaba Cloud lain.

    • marketplace: image yang disediakan oleh pasar Alibaba Cloud. Anda dapat menggunakan image pasar Alibaba Cloud secara langsung tanpa harus berlangganan terlebih dahulu. Periksa detail penagihan image pasar Alibaba Cloud secara mandiri.

    system
    ImageOwnerAlias

    string

    No

    Apakah akan menggunakan kata sandi bawaan dari image.

    Catatan

    Saat Anda menggunakan parameter ini, parameter Password harus kosong. Pastikan image yang Anda gunakan memiliki kata sandi bawaan.

    false
    PasswordInherit

    boolean

    No

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

    ecs.g5.Tingkat Tinggi
    InstanceType

    string

    No

    ID grup keamanan tempat instans baru berada. Instans dalam grup keamanan yang sama dapat berkomunikasi satu sama lain. Satu grup keamanan dapat menampung hingga 1.000 instans.

    Catatan

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

    sg-bp15ed6xe1yxeycg****
    SecurityGroupId

    string

    No

    ID virtual private cloud (VPC).

    vpc-bp12433upq1y5scen****
    VpcId

    string

    No

    ID vSwitch. Parameter ini diperlukan saat Anda membuat instans yang terhubung ke VPC.

    vsw-bp1s5fnvk4gn2tws0****
    VSwitchId

    string

    No

    Nama instans. Panjang nama harus 2 hingga 128 karakter dan dapat mengandung karakter dari kategori huruf Unicode (termasuk huruf dalam bahasa Inggris, bahasa Tionghoa, dan digit). Nama dapat mengandung titik dua (:), garis bawah (_), titik (.), dan tanda hubung (-). Nilai default adalah InstanceId dari instans.

    Saat Anda membuat beberapa Instance ECS, Anda dapat menetapkan nama instans berurutan yang mengandung kurung siku ([]) dan koma (,). Untuk informasi selengkapnya, lihat Mengonfigurasi nama atau hostname berurutan secara batch untuk beberapa instans.

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

    string

    No

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

    testECSDescription
    Description

    string

    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 besar dari 10 Mbit/s: 1 hingga nilai InternetMaxBandwidthOut. Nilai default: nilai InternetMaxBandwidthOut.

    10
    InternetMaxBandwidthIn

    integer

    No

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

    10
    InternetMaxBandwidthOut

    integer

    No

    Hostname server Elastic Compute Service.

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

    • Untuk instans Windows: Panjang hostname harus 2 hingga 15 karakter dan tidak boleh mengandung titik (.) atau seluruhnya terdiri dari digit. Hostname dapat mengandung huruf, digit, dan tanda hubung (-).

    • Untuk instans lain seperti Linux: Panjang hostname harus 2 hingga 64 karakter. Anda dapat menggunakan titik (.) untuk memisahkan hostname menjadi beberapa segmen. Setiap segmen dapat mengandung huruf, digit, dan tanda hubung (-).

    testHostName
    HostName

    string

    No

    ID zona instans.

    cn-hangzhou-g
    ZoneId

    string

    No

    Kategori disk sistem. Nilai valid:

    • cloud: disk dasar.

    • cloud_efficiency: disk ultra.

    • cloud_ssd: SSD standar.

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

    • cloud_auto: disk ESSD AutoPL.

    • cloud_essd_entry: disk ESSD Entry.

    Untuk tipe instans yang sudah pensiun dan bukan instans yang dioptimalkan I/O, nilai default adalah cloud. Untuk tipe instans lain, nilai default adalah cloud_efficiency.

    cloud_ssd
    SystemDisk.Category

    string

    No

    Ukuran disk sistem. Unit: GiB. Nilai valid:

    • cloud: 20 hingga 500.

    • Kategori disk lain: 20 hingga 2048.

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

    40
    SystemDisk.Size

    integer

    No

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

    testSystemDiskName
    SystemDisk.DiskName

    string

    No

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

    testSystemDiskDescription
    SystemDisk.Description

    string

    No

    Catatan

    Parameter ini berada dalam pratinjau undangan dan tidak tersedia untuk publik.

    null
    SystemDisk.Iops

    integer

    No

    Tingkat kinerja ESSD yang digunakan sebagai disk sistem. Pengaturan untuk tingkat kinerja disk. Nilai valid:

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

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

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

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

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

    PL0
    SystemDisk.PerformanceLevel

    string

    No

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

    • true: Disk sistem dirilis bersama dengan instans.

    • false: Disk sistem tidak dirilis bersama dengan instans.

    Nilai default: true.

    true
    SystemDisk.DeleteWithInstance

    boolean

    No

    ID kebijakan snapshot otomatis yang diterapkan pada disk sistem.

    sp-gc7c37d4ylw7mtnk****
    SystemDisk.AutoSnapshotPolicyId

    string

    No

    IOPS baca/tulis yang disediakan untuk disk ESSD AutoPL. Nilai valid: 0 hingga min{50000, 1000 × Kapasitas - Kinerja dasar}.

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

    Catatan

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

    50000
    SystemDisk.ProvisionedIops

    integer

    No

    Apakah akan mengaktifkan fitur lonjakan performa. Nilai valid:

    • true: Mengaktifkan fitur lonjakan performa.

    • false: Menonaktifkan fitur lonjakan performa.

    true
    SystemDisk.BurstingEnabled

    boolean

    No

    Apakah instans dioptimalkan I/O. Nilai valid:

    • none: Instans tidak dioptimalkan I/O.

    • optimized: Instans dioptimalkan I/O.

    optimized
    IoOptimized

    string

    No

    Metode penagihan instans. Nilai valid:

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

    • PostPaid: bayar sesuai pemakaian.

    PrePaid
    InstanceChargeType

    string

    No

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

    1
    Period

    integer

    No

    Metode penagihan untuk penggunaan jaringan. Nilai valid:

    • PayByBandwidth: bayar berdasarkan bandwidth.

    • PayByTraffic: bayar berdasarkan trafik.

    Catatan

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

    PayByTraffic
    InternetChargeType

    string

    No

    Apakah akan mengaktifkan konfigurasi sistem operasi instans.

    Catatan

    Parameter ini akan dihentikan. Gunakan parameter lain untuk kompatibilitas yang lebih baik.

    false
    EnableVmOsConfig

    boolean

    No

    Jenis jaringan instans. Nilai valid:

    • classic: jaringan klasik. Fitur ini telah pensiun. Untuk informasi selengkapnya, lihat Pemberitahuan pensiun.

    • vpc: VPC.

    vpc
    NetworkType

    string

    No

    Data pengguna instans. Data pengguna instans harus dienkode dalam Base64. Ukuran data mentah dapat mencapai 32 KB.

    ZWNbyBoZWxsbyBlY3Mh
    UserData

    string

    No

    Nama pasangan kunci.

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

    • Untuk instans Linux, metode masuk kata sandi dinonaktifkan selama inisialisasi.

    testKeyPairName
    KeyPairName

    string

    No

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

    testRamRoleName
    RamRoleName

    string

    No

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

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

    • Waktu pelepasan paling awal harus setidaknya setengah jam dari waktu saat ini.

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

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

    string

    No

    Kebijakan preemption untuk instans bayar sesuai pemakaian. Parameter ini berlaku ketika InstanceChargeType diatur ke PostPaid. Nilai valid:

    • NoSpot: Instans adalah instans bayar sesuai pemakaian reguler.

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

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

    NoSpot
    SpotStrategy

    string

    No

    Harga maksimum per jam instans. Parameter ini mendukung hingga tiga tempat desimal dan berlaku ketika SpotStrategy diatur ke SpotWithPriceLimit.

    0.97
    SpotPriceLimit

    number

    No

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

    • 1: Setelah spot instans dibuat, Alibaba Cloud memastikan bahwa instans tidak dilepas secara otomatis dalam 1 jam. Setelah periode perlindungan 1 jam berakhir, sistem membandingkan harga penawaran dengan harga pasar dan memeriksa inventaris Sumber daya untuk menentukan apakah instans akan dipertahankan atau dilepas secara otomatis.

    • 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 Sumber daya untuk menentukan apakah instans akan dipertahankan atau dilepas secara otomatis.

    Alibaba Cloud mengirimkan notifikasi peristiwa sistem ECS 5 menit sebelum instans dilepas. Spot instans ditagih per detik. Pilih periode perlindungan yang sesuai berdasarkan durasi eksekusi tugas yang diharapkan.

    Catatan

    Parameter ini berlaku ketika SpotStrategy diatur ke SpotWithPriceLimit atau SpotAsPriceGo.

    1
    SpotDuration

    integer

    No

    ID kelompok sumber daya perusahaan tempat instans, penyimpanan blok, dan pengontrol antarmuka jaringan (NIC) berada.

    rg-bp67acfmxazb4p****
    ResourceGroupId

    string

    No

    ID kelompok sumber daya perusahaan tempat template peluncuran berada.

    rg-bp67acfmxazb4p****
    TemplateResourceGroupId

    string

    No

    Apakah akan mengaktifkan penguatan keamanan untuk sistem operasi. Nilai valid:

    • Active: Mengaktifkan penguatan keamanan. Nilai ini hanya berlaku untuk image publik.

    • Deactive: Menonaktifkan penguatan keamanan. Nilai ini berlaku untuk semua jenis image.

    Deactive
    SecurityEnhancementStrategy

    string

    No

    Alamat IP pribadi instans.

    Untuk menetapkan alamat IP pribadi ke Instance ECS yang terhubung ke VPC, pilih alamat IP yang tersedia dari blok CIDR vSwitch (VSwitchId).

    10.1.**.**
    PrivateIpAddress

    string

    No

    ID set penyebaran.

    ds-bp1brhwhoqinyjd6****
    DeploymentSetId

    string

    No

    Jumlah alamat IPv6 yang dihasilkan secara acak untuk ditetapkan ke ENI primer. Nilai valid: 1 hingga 10.

    1
    Ipv6AddressCount

    integer

    No

    Daftar konfigurasi disk data.

    1
    DataDisk

    array<object>

    No

    Informasi Elastic Network Interface (ENI).

    object

    No

    Informasi Elastic Network Interface (ENI).

    PerformanceLevel

    string

    No

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

    • PL0: satu disk dapat mengirimkan hingga 10.000 IOPS baca/tulis acak.

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

    • PL2: satu disk dapat mengirimkan hingga 100.000 IOPS baca/tulis acak.

    • PL3: satu disk dapat mengirimkan hingga 1.000.000 IOPS baca/tulis acak.

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

    PL1
    Description

    string

    No

    Deskripsi Elastic Network Interface (ENI) sekunder. Deskripsi harus memiliki panjang 2 hingga 256 karakter dan tidak boleh diawali dengan http:// atau https://. Nilai N pada NetworkInterface.N tidak boleh lebih besar dari 1.

    testEniDescription
    SnapshotId

    string

    No

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

    Catatan

    Anda tidak dapat menggunakan snapshot yang dibuat pada atau sebelum 15 Juli 2013. Permintaan 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 bervariasi berdasarkan jumlah disk data yang disambungkan:

    • 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 ditujukan untuk skenario image penuh (image seluruh mesin). 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 dimulai dengan huruf dan tidak boleh dimulai dengan http:// atau https://. Nama dapat mengandung digit, 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 ketika InstanceType diatur ke keluarga instans ecs.u1 atau ecs.e.

    • elastic_ephemeral_disk_standard: disk ephemeral elastis - 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. Deskripsi nilai default:

    • Jika InstanceType adalah tipe instans yang sudah dihentikan dan tidak dioptimalkan untuk I/O, nilai default parameter ini 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
    AutoSnapshotPolicyId

    string

    No

    ID kebijakan snapshot otomatis yang diterapkan pada disk data.

    sp-m5e7fa9ute44ssa****
    ProvisionedIops

    integer

    No

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

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

    Catatan

    Parameter ini hanya didukung ketika 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
    KMSKeyId

    string

    No

    ID kunci KMS untuk disk data.

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

    array<object>

    No

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

    Skenario

    Setelah Anda memanggil operasi CreateLaunchTemplate untuk membuat templat, versi default yang dibuat otomatis digunakan untuk membuat instans. Tag ini diterapkan ke instans, disk, dan ENI primer.

    object

    No

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

    VSwitchId

    string

    No

    ID vSwitch dari pengontrol antarmuka jaringan (NIC).

    Perhatikan hal-hal berikut:

    • Nilai valid N: 1 hingga 2. Jika Anda mengatur N ke 1, Anda dapat mengonfigurasi NIC primer atau sekunder. Jika Anda mengatur N ke 2, Anda harus mengonfigurasi satu NIC primer dan satu NIC sekunder.

    • Jika NetworkInterface.N.InstanceType diatur ke Primary, parameter ini diperlukan. Parameter ini memiliki efek yang sama dengan VSwitchId, tetapi Anda tidak dapat menentukan parameter ini dan VSwitchId secara bersamaan.

    • Jika NetworkInterface.N.InstanceType diatur ke Secondary atau dikosongkan, parameter ini bersifat opsional. Nilai default: vSwitch instans ECS.

    vsw-bp1s5fnvk4gn2tws0****
    NetworkInterfaceName

    string

    No

    Nama pengontrol antarmuka jaringan (NIC).

    Perhatikan hal-hal berikut:

    • Nilai valid N: 1 hingga 2. Jika Anda mengatur N ke 1, Anda dapat mengonfigurasi NIC primer atau sekunder. Jika Anda mengatur N ke 2, Anda harus mengonfigurasi satu NIC primer dan satu NIC sekunder.

    • Jika NetworkInterface.N.InstanceType diatur ke Primary, Anda tidak perlu mengatur parameter ini.

    testEniName
    Description

    string

    No

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

    testEniDescription
    SecurityGroupId

    string

    No

    ID grup keamanan tempat pengontrol antarmuka jaringan (NIC) berada.

    Perhatikan hal-hal berikut:

    • Nilai valid N: 1 hingga 2. Jika Anda mengatur N ke 1, Anda dapat mengonfigurasi NIC primer atau sekunder. Jika Anda mengatur N ke 2, Anda harus mengonfigurasi satu NIC primer dan satu NIC sekunder.

    • Jika NetworkInterface.N.InstanceType diatur ke Primary, Anda harus mengatur parameter ini. Parameter ini memiliki efek yang sama dengan SecurityGroupId, tetapi Anda tidak dapat menentukan SecurityGroupId, SecurityGroupIds.N, atau NetworkInterface.N.SecurityGroupIds.N.

    • Jika NetworkInterface.N.InstanceType diatur ke Secondary atau dikosongkan, parameter ini bersifat opsional. Nilai default: grup keamanan instans ECS.

    sg-bp15ed6xe1yxeycg****
    PrimaryIpAddress

    string

    No

    Menambahkan pengontrol antarmuka jaringan (NIC.

    192.168.**.**
    SecurityGroupIds

    array

    No

    ID satu atau beberapa grup keamanan tempat pengontrol antarmuka jaringan (NIC) berada.

    • N pertama memiliki rentang nilai valid 1 hingga 2. Jika Anda mengatur N ke 1, Anda dapat mengonfigurasi NIC primer atau sekunder. Jika Anda mengatur N ke 2, Anda harus mengonfigurasi satu NIC primer dan satu NIC sekunder.

    • N kedua menentukan satu atau beberapa ID grup keamanan. Rentang nilai valid N bergantung pada jumlah maksimum grup keamanan tempat sebuah instans dapat berada. Untuk informasi selengkapnya, lihat Batas grup keamanan.

    Perhatikan hal-hal berikut:

    • Jika NetworkInterface.N.InstanceType diatur ke Primary, Anda harus mengatur parameter ini atau NetworkInterface.N.SecurityGroupId. Parameter ini memiliki efek yang sama dengan SecurityGroupIds.N, tetapi Anda tidak dapat menentukan SecurityGroupId, SecurityGroupIds.N, atau NetworkInterface.N.SecurityGroupId.

    • Jika NetworkInterface.N.InstanceType diatur ke Secondary atau dikosongkan, parameter ini bersifat opsional. Nilai default: grup keamanan instans ECS.

    sg-bp67acfmxazb4p****

    string

    No

    ID satu atau beberapa grup keamanan tempat pengontrol antarmuka jaringan (NIC) berada.

    • N pertama memiliki rentang nilai valid 1 hingga 2. Jika Anda mengatur N ke 1, Anda dapat mengonfigurasi NIC primer atau sekunder. Jika Anda mengatur N ke 2, Anda harus mengonfigurasi satu NIC primer dan satu NIC sekunder.

    • N kedua menentukan satu atau beberapa ID grup keamanan. Rentang nilai valid N bergantung pada jumlah maksimum grup keamanan tempat sebuah instans dapat berada. Untuk informasi selengkapnya, lihat Batas grup keamanan.

    Perhatikan hal-hal berikut:

    • Jika NetworkInterface.N.InstanceType diatur ke Primary, Anda harus mengatur parameter ini atau NetworkInterface.N.SecurityGroupId. Parameter ini memiliki efek yang sama dengan SecurityGroupIds.N, tetapi Anda tidak dapat menentukan SecurityGroupId, SecurityGroupIds.N, atau NetworkInterface.N.SecurityGroupId.

    • Jika NetworkInterface.N.InstanceType diatur ke Secondary atau dikosongkan, parameter ini bersifat opsional. Nilai default: grup keamanan instans ECS.

    sg-bp67acfmxazb4p****
    InstanceType

    string

    No

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

    Nilai valid:

    • Primary: NIC primer.

    • Secondary: NIC sekunder.

    Nilai default: Secondary.

    Secondary
    NetworkInterfaceTrafficMode

    string

    No

    The communication mode of the primary ENI. Valid values:

    • Standard: uses the TCP communication mode.

    • HighPerformance: enables the Elastic RDMA Interface (ERI) and uses the RDMA communication mode.

    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

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

    Catatan

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

    sg-bp15ed6xe1yxeycg7****

    object

    No

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

    Catatan

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

    sg-bp15ed6xe1yxeycg7****
    Key

    string

    No

    Kunci tag untuk instans, disk, dan ENI primer yang dibuat dari versi template ini. Nilai valid N: 1 hingga 20. Kunci tag tidak boleh berupa string kosong. Kunci tag dapat memiliki panjang hingga 128 karakter dan tidak boleh dimulai dengan aliyun atau acs:. Kunci tag tidak boleh mengandung http:// atau https://.

    TestKey
    Value

    string

    No

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

    TestValue
    SecurityGroupIds

    array

    No

    Apakah akan mengenkripsi disk sistem. Nilai valid:

    • true: mengenkripsi disk sistem.

    • false: tidak mengenkripsi disk sistem.

    Nilai default: false.

    Catatan

    Zona D di Hong Kong (Tiongkok) dan Zona A di Singapura tidak mendukung enkripsi disk sistem saat Anda membuat instans.

    false

    string

    No

    The IDs of one or more security groups to which the instance belongs. The valid value range of N depends on the maximum number of security groups to which an instance can belong. For more information, see Limits.

    Catatan

    You cannot specify both SecurityGroupId and SecurityGroupIds.N.

    sg-bp15ed6xe1yxeycg7****
    SystemDisk.Encrypted

    string

    No

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

    • true: mengaktifkan perlindungan pelepasan untuk instans.

    • false: menonaktifkan perlindungan pelepasan untuk instans.

    Nilai default: false.

    Catatan

    Atribut ini hanya berlaku untuk instans pay-as-you-go. Atribut ini hanya dapat mencegah operasi pelepasan manual, bukan operasi pelepasan yang diinisiasi sistem.

    false
    DeletionProtection

    boolean

    No

    Mode berjalan Instance Burstable. Nilai valid:

    Standard
    CreditSpecification

    string

    No

    Apakah akan mengaktifkan perpanjangan otomatis. Nilai valid:

    • true: mengaktifkan perpanjangan otomatis.

    • false: tidak mengaktifkan perpanjangan otomatis.

    Nilai default: false.

    Catatan

    Parameter ini hanya berlaku jika InstanceChargeType diatur ke PrePaid.

    true
    AutoRenew

    boolean

    No

    Periode perpanjangan otomatis untuk satu kali perpanjangan. Nilai valid:

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

    Nilai default: 1.

    1
    AutoRenewPeriod

    integer

    No

    Unit periode langganan. Nilai valid:

    Month (default).

    Month
    PeriodUnit

    string

    No

    Apakah akan mengaktifkan saluran akses untuk metadata instans. Nilai valid:

    • enabled: mengaktifkan saluran akses.

    • disabled: menonaktifkan saluran akses.

    Nilai default: enabled.

    Catatan

    Untuk informasi selengkapnya tentang metadata instans, lihat Ikhtisar metadata instans.

    enabled
    HttpEndpoint

    string

    No

    Apakah akan menggunakan mode penguatan keamanan (IMDSv2) secara paksa untuk mengakses metadata instans. Nilai valid:

    • optional: tidak menggunakan mode penguatan keamanan secara paksa.

    • required: menggunakan mode penguatan keamanan secara paksa. Setelah Anda mengatur parameter ini ke required, Anda tidak dapat mengakses metadata instans dalam mode normal.

    Nilai default: optional.

    Catatan

    Untuk informasi selengkapnya tentang mode untuk mengakses metadata instans, lihat Ikhtisar metadata instans.

    optional
    HttpTokens

    string

    No

    Catatan

    Parameter ini tidak tersedia untuk digunakan.

    3
    HttpPutResponseHopLimit

    integer

    No

    ID kunci KMS disk sistem.

    0e478b7a-4262-4802-b8cb-00d3fb40****
    SystemDisk.KMSKeyId

    string

    No

    Informasi properti terkait image.

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

    object

    No

    Opsi keamanan.

    LoginAsNonRoot

    boolean

    No

    Indicates whether the instance that uses this image supports logon with the ecs-user account. 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.

    • Enhanced instance families (g7t, c7t, and r7t).

    When you create ECS instances of the preceding instance types, you must configure this parameter. Take note of the following items:

    • To use Alibaba Cloud Trusted System, set this parameter to vTPM. Then, Alibaba Cloud Trusted System performs trusted verification when the instance starts.

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

    • When you use OpenAPI to create a trusted ECS instance, you can only invoke RunInstances. CreateInstance does not support the SecurityOptions.TrustedSystemMode parameter.

    Catatan

    If you specify the instance as a trusted instance during creation, you can replace the system disk only with an image that supports the trusted system.

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

    vTPM
    EnableSecureBoot

    boolean

    No

    Elemen respons

    Element

    Type

    Description

    Example

    object

    LaunchTemplateId

    string

    ID template peluncuran.

    lt-m5eiaupmvm2op9d****
    RequestId

    string

    ID permintaan.

    473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
    LaunchTemplateVersionNumber

    integer

    Nomor versi template peluncuran.

    20

    Contoh

    Respons sukses

    JSONformat

    {
  "LaunchTemplateId": "lt-m5eiaupmvm2op9d****",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "LaunchTemplateVersionNumber": 20
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 InvalidRegion.NotExist %s Wilayah yang ditentukan tidak ada.
    400 MissingParameter %s Setidaknya satu dari parameter yang ditentukan harus disediakan. Parameter-parameter tersebut tidak boleh semuanya kosong.
    400 InvalidParameter %s Kombinasi parameter yang ditentukan tidak valid.
    400 InvalidLaunchTemplateName.Malformed The specified parameter LaunchTemplateName is not valid. Parameter LaunchTemplateName yang ditentukan tidak valid.
    400 InvalidDescription.Malformed The specified parameter "VersionDescription" is not valid.
    400 InvalidUserData.SizeExceeded %s Ukuran data yang Anda tentukan melebihi nilai maksimum yang diizinkan.
    400 InvalidUserData.Base64FormatInvalid %s Parameter UserData yang ditentukan harus dienkode Base64.
    400 Duplicate.TagKey The Tag.N.Key contain duplicate key. Terdapat kunci duplikat dalam tag. Pastikan kunci bersifat unik.
    400 InvalidTagKey.Malformed The specified Tag.n.Key is not valid. Kunci tag yang ditentukan tidak valid. Kunci tag tidak boleh kosong atau null, dapat berisi hingga 128 karakter, dan tidak boleh dimulai dengan "aliyun" atau "acs:" atau mengandung "http://" atau "https://".
    400 InvalidTagValue.Malformed The specified Tag.n.Value is not valid. Nilai tag yang ditentukan tidak valid. Nilai tag dapat berisi hingga 128 karakter dan tidak boleh mengandung "http://" atau "https://".
    400 InvalidHostName.Malformed The specified parameter "HostName" is not valid. Parameter HostName yang ditentukan tidak valid.
    400 InvalidParams.CreateEniParams %s
    500 InternalError The request processing has failed due to some unknown error.
    403 LaunchTemplateLimitExceed %s Jumlah maksimum template peluncuran telah terlampaui.
    403 LaunchTemplateName.Duplicated %s Nama template peluncuran yang ditentukan sudah ada.
    403 QuotaExceed.Tags %s Kuota parameter tag telah terlampaui. Nilai maksimum adalah 20.
    403 InvalidOperation.InstanceTypeSecureBootUnsupported The instance type does not support secure boot. Tipe instans tidak mendukung Secure Boot.
    403 InvalidOperation.SecureBootRegionNotSupported Secure Boot is not available in the specified region. Wilayah saat ini tidak mendukung pengaktifan Secure Boot untuk instans.
    404 InvalidResourceGroup.NotFound The ResourceGroup provided does not exist in our records. Kelompok sumber daya terkait tidak ditemukan.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.