All Products
Search
Document Center

Elastic Compute Service:CreateLaunchTemplate

Last Updated:Jul 04, 2026

Membuat template peluncuran instans ECS. Template peluncuran menghilangkan kebutuhan untuk mengonfigurasi sejumlah pengatur waktu parameter yang besar setiap kali Anda membuat instans.

Deskripsi operasi

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

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

Saat 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 membuat instans.

  • Jika konfigurasi ditentukan dalam template peluncuran, konfigurasi tersebut tidak dapat difilter saat Anda membuat instans (RunInstances). Misalnya, jika template menentukan HostName=LocalHost dan nilai HostName dikosongkan di RunInstances, hostname instans tetap LocalHost. Untuk mengganti konfigurasi HostName=LocalHost, atur 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

Pasangan kunci-nilai tag dari template peluncuran itu sendiri.

Catatan

Saat ini, Anda hanya dapat membuat dan mengkueri tag untuk template peluncuran menggunakan operasi API. Konsol tidak mendukung pembuatan atau penampilan tag ini.

object

No

Pasangan kunci-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. 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 dari template peluncuran. Nilai valid N: 1 hingga 20. Nilai tag dapat berupa string kosong. Nilai tag dapat memiliki panjang hingga 128 karakter dan tidak boleh dimulai dengan aliyun atau acs:. Nilai tag tidak boleh mengandung http:// atau https://.

TestValue

RegionId

string

Yes

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

cn-hangzhou

LaunchTemplateName

string

Yes

Nama template peluncuran. 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 (-).

testLaunchTemplateName

VersionDescription

string

No

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

testVersionDescription

ImageId

string

No

ID image. 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. Nilai valid:

  • system: gambar publik yang disediakan oleh Alibaba Cloud.

  • self: gambar kustom yang Anda buat.

  • others: gambar bersama dari akun Alibaba Cloud lain.

  • marketplace: image dari Alibaba Cloud Marketplace. Anda dapat menggunakan image Alibaba Cloud Marketplace secara langsung tanpa berlangganan terlebih dahulu. Periksa detail penagihan image Alibaba Cloud Marketplace secara mandiri.

system

PasswordInherit

boolean

No

Apakah akan menggunakan kata sandi yang telah ditetapkan dalam image.

Catatan

Saat menggunakan parameter ini, parameter Password harus kosong. Pastikan image yang Anda gunakan telah dikonfigurasi dengan kata sandi.

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 berada. Instans dalam grup keamanan yang sama dapat saling berkomunikasi. Sebuah grup keamanan dapat berisi hingga 1.000 instans.

Catatan

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

sg-bp15ed6xe1yxeycg****

VpcId

string

No

ID virtual private cloud (VPC).

vpc-bp12433upq1y5scen****

VSwitchId

string

No

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

vsw-bp1s5fnvk4gn2tws0****

InstanceName

string

No

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

Saat membuat beberapa instans ECS, Anda dapat menentukan nama instans berurutan. Nama dapat mengandung tanda kurung siku ([]) dan koma (,). Untuk informasi selengkapnya, lihat Menentukan nama instans atau hostname berurutan.

k8s-node-[1,4]-alibabacloud

Description

string

No

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

testECSDescription

InternetMaxBandwidthIn

integer

No

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

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

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

10

InternetMaxBandwidthOut

integer

No

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

10

HostName

string

No

Hostname server Elastic Compute Service.

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

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

  • Instans lain (seperti Linux): Hostname harus terdiri dari 2 hingga 64 karakter. Hostname dapat mengandung beberapa titik (.), dengan setiap segmen di antara titik memperbolehkan huruf, digit, 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_essd: SSD Perusahaan (ESSD). Anda dapat menggunakan parameter SystemDisk.PerformanceLevel untuk mengatur tingkat kinerja disk.

  • cloud_auto: disk ESSD AutoPL.

  • cloud_essd_entry: disk ESSD Entry.

Untuk tipe instans yang sudah dihentikan dan tidak dioptimalkan untuk I/O, nilai defaultnya adalah cloud. Selain itu, nilai defaultnya adalah cloud_efficiency.

cloud_ssd

SystemDisk.Size

integer

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

string

No

Nama disk sistem. 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 (-).

testSystemDiskName

SystemDisk.Description

string

No

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

testSystemDiskDescription

SystemDisk.Iops

integer

No

Catatan

Parameter ini dalam pratinjau undangan dan tidak tersedia untuk umum.

null

SystemDisk.PerformanceLevel

string

No

Tingkat kinerja ESSD yang digunakan sebagai disk sistem. 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.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-gc7c37d4ylw7mtnk****

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

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 dioptimalkan untuk I/O. Nilai valid:

  • none: tidak dioptimalkan untuk I/O.

  • optimized: dioptimalkan untuk 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, error InvalidPayMethod dikembalikan.

  • PostPaid: bayar sesuai penggunaan.

PrePaid

Period

integer

No

Durasi langganan resource. Unit: bulan. Parameter ini berlaku dan diperlukan hanya ketika 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 penggunaan jaringan. Nilai valid:

  • PayByBandwidth: bayar berdasarkan bandwidth.

  • PayByTraffic: bayar berdasarkan trafik.

Catatan

Dalam mode bayar berdasarkan trafik, bandwidth arah masuk dan arah keluar puncak digunakan sebagai batas atas bandwidth, bukan sebagai metrik layanan yang dijamin. Saat terjadi konflik sumber daya, bandwidth puncak mungkin dibatasi. Jika beban kerja Anda memerlukan bandwidth yang terjamin, gunakan mode bayar berdasarkan bandwidth.

PayByTraffic

EnableVmOsConfig

boolean

No

Apakah akan mengaktifkan konfigurasi sistem operasi instans.

Catatan

Parameter ini akan dihentikan. Untuk kompatibilitas yang lebih baik, gunakan parameter lain.

false

NetworkType

string

No

Jenis jaringan instans. Nilai valid:

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

  • vpc: VPC.

vpc

UserData

string

No

Data pengguna instans. Data harus dikodekan dalam Base64. Ukuran maksimum data mentah adalah 32 KB.

ZWNobyBoZWxsbyBlY3Mh

KeyPairName

string

No

Nama key pair.

  • 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 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 bawah 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 ketika 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 menggunakan harga pasar pada saat pembelian secara otomatis sebagai harga penawaran.

NoSpot

SpotPriceLimit

number

No

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

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 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. Pilih periode perlindungan yang sesuai berdasarkan perkiraan durasi eksekusi tugas.

Catatan

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

1

ResourceGroupId

string

No

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

rg-bp67acfmxazb4p****

TemplateResourceGroupId

string

No

ID kelompok sumber daya tempat template peluncuran berada.

rg-bp67acfmxazb4p****

SecurityEnhancementStrategy

string

No

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

  • Active: mengaktifkan penguatan keamanan. Nilai ini hanya berlaku untuk gambar publik.

  • Deactive: tidak mengaktifkan penguatan keamanan. Nilai ini berlaku untuk semua tipe image.

Deactive

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 vSwitch yang tidak terpakai (VSwitchId).

10.1.**.**

DeploymentSetId

string

No

ID set penyebaran.

ds-bp1brhwhoqinyjd6****

Ipv6AddressCount

integer

No

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

1

DataDisk

array<object>

No

Daftar informasi disk data.

object

No

Daftar informasi 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. 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 disk data. Deskripsi harus terdiri dari 2 hingga 256 karakter dan tidak boleh dimulai dengan http:// atau https://.

testDataDiskDescription

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

Informasi pengontrol antarmuka jaringan (NIC).

object

No

Informasi pengontrol antarmuka jaringan (NIC).

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

Tag untuk instans, disk, dan ENI primer yang dibuat dari versi template ini.

Skenario

Setelah Anda memanggil CreateLaunchTemplate untuk membuat template, versi default yang dibuat secara otomatis menggunakan tag ini untuk menandai instans, disk, dan ENI primer saat Anda membuat instans.

object

No

Tag untuk instans, disk, dan ENI primer yang dibuat dari versi template ini.

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

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

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

Specifies whether to encrypt the system disk. Valid values:

  • true: encrypts the system disk.

  • false: does not encrypt the system disk.

Default value: false.

Catatan

Zone D in Hong Kong (China) and Zone A in Singapore do not support system disk encryption when you create instances.

false

DeletionProtection

boolean

No

The release protection attribute of the instance. Specifies whether the instance can be released from the console or by calling DeleteInstance. Valid values:

  • true: enables release protection.

  • false: disables release protection.

Default value: false.

Catatan

This attribute applies only to pay-as-you-go instances. It can only restrict manual release operations and does not affect system-initiated releases.

false

CreditSpecification

string

No

The running mode of the burstable instance. Valid values:

Standard

AutoRenew

boolean

No

Specifies whether to enable auto-renewal. Valid values:

  • true: enables auto-renewal.

  • false: does not enable auto-renewal.

Default value: false.

Catatan

This parameter takes effect only when InstanceChargeType is set to PrePaid.

true

AutoRenewPeriod

integer

No

The auto-renewal period. Valid values:

If PeriodUnit is set to Month: 1, 2, 3, 6, 12, 24, 36, 48, and 60.

Default value: 1.

1

PeriodUnit

string

No

The unit of the subscription billable methods duration. Valid values:

Month (default).

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, instance metadata cannot be accessed in normal mode.

Default value: optional.

Catatan

For more information about the modes for Instance metadata overview

optional

HttpPutResponseHopLimit

integer

No

Catatan

This parameter is not available for use.

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

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

Elemen respons

Element

Type

Description

Example

object

LaunchTemplateId

string

The launch template ID.

lt-m5eiaupmvm2op9d****

RequestId

string

ID permintaan.

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

LaunchTemplateVersionNumber

integer

The launch template version number.

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
400 MissingParameter %s
400 InvalidParameter %s
400 InvalidLaunchTemplateName.Malformed The specified parameter LaunchTemplateName is not valid.
400 InvalidDescription.Malformed The specified parameter "VersionDescription" is not valid.
400 InvalidUserData.SizeExceeded %s
400 InvalidUserData.Base64FormatInvalid %s
400 Duplicate.TagKey The Tag.N.Key contain duplicate key.
400 InvalidTagKey.Malformed The specified Tag.n.Key is not valid.
400 InvalidTagValue.Malformed The specified Tag.n.Value is not valid.
400 InvalidHostName.Malformed The specified parameter "HostName" is not valid.
400 InvalidParams.CreateEniParams %s
500 InternalError The request processing has failed due to some unknown error.
403 LaunchTemplateLimitExceed %s
403 LaunchTemplateName.Duplicated %s
403 QuotaExceed.Tags %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.