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=LocalHostdan nilaiHostNamedikosongkan diRunInstances, hostname instans tetapLocalHost. Untuk mengganti konfigurasiHostName=LocalHost, aturHostName=MyHostatau nilai lain diRunInstances.
Coba sekarang
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
ecs:CreateLaunchTemplate |
create |
*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 |
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 |
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 |
testLaunchTemplateName |
| VersionDescription |
string |
No |
Deskripsi versi template peluncuran. Deskripsi harus terdiri dari 2 hingga 256 karakter dan tidak boleh dimulai dengan |
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 |
| 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 |
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 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 |
testECSDescription |
| InternetMaxBandwidthIn |
integer |
No |
Bandwidth publik arah masuk maksimum. Unit: Mbit/s. Nilai valid:
|
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.
|
testHostName |
| ZoneId |
string |
No |
ID zona instans. |
cn-hangzhou-g |
| SystemDisk.Category |
string |
No |
Kategori disk sistem. Nilai valid:
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:
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 |
testSystemDiskName |
| SystemDisk.Description |
string |
No |
Deskripsi disk sistem. Deskripsi harus terdiri dari 2 hingga 256 karakter dan tidak boleh dimulai dengan |
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:
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:
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 |
| IoOptimized |
string |
No |
Apakah instans dioptimalkan untuk I/O. Nilai valid:
|
optimized |
| InstanceChargeType |
string |
No |
Metode penagihan instans. Nilai valid:
|
PrePaid |
| Period |
integer |
No |
Durasi langganan resource. Unit: bulan. Parameter ini berlaku dan diperlukan hanya ketika |
1 |
| InternetChargeType |
string |
No |
Metode penagihan untuk penggunaan jaringan. Nilai valid:
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:
|
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.
|
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.
|
2018-01-01T12:05:00Z |
| SpotStrategy |
string |
No |
Kebijakan preemsi untuk instans bayar sesuai penggunaan. Parameter ini berlaku ketika
|
NoSpot |
| SpotPriceLimit |
number |
No |
Harga per jam maksimum instans. Parameter ini mendukung hingga tiga desimal dan berlaku ketika |
0.97 |
| SpotDuration |
integer |
No |
Periode perlindungan spot instans. Unit: jam. Nilai default: 1. Nilai valid:
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:
|
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 ( |
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
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 |
testDataDiskDescription |
| SnapshotId |
string |
No |
ID snapshot yang digunakan untuk membuat disk data N. Nilai valid N: 1 hingga 16. Setelah Anda menentukan 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:
Nilai parameter ini harus lebih besar dari atau sama dengan ukuran snapshot yang ditentukan oleh |
2000 |
| Device |
string |
No |
Titik pemasangan disk data. Konvensi penamaan bervariasi berdasarkan jumlah disk data yang disambungkan:
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 |
/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 |
testDataDiskName |
| Category |
string |
No |
Kategori disk data N. Nilai valid:
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:
|
cloud_ssd |
| DeleteWithInstance |
boolean |
No |
Apakah akan merilis disk data saat instans dirilis. Nilai valid:
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 |
| 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:
|
vsw-bp1s5fnvk4gn2tws0**** |
| NetworkInterfaceName |
string |
No |
Nama pengontrol antarmuka jaringan (NIC). Perhatikan hal-hal berikut:
|
testEniName |
| Description |
string |
No |
Deskripsi pengontrol antarmuka jaringan (NIC) sekunder. Deskripsi harus terdiri dari 2 hingga 256 karakter dan tidak boleh dimulai dengan |
testEniDescription |
| SecurityGroupId |
string |
No |
ID grup keamanan tempat pengontrol antarmuka jaringan (NIC) berada. Perhatikan hal-hal berikut:
|
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.
Perhatikan hal-hal berikut:
|
sg-bp67acfmxazb4p**** |
|
string |
No |
ID satu atau beberapa grup keamanan tempat pengontrol antarmuka jaringan (NIC) berada.
Perhatikan hal-hal berikut:
|
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:
Nilai default: Secondary. |
Secondary |
| NetworkInterfaceTrafficMode |
string |
No |
The communication mode of the primary ENI. Valid values:
|
Standard |
| DeleteOnRelease |
boolean |
No |
Apakah akan mempertahankan ENI saat instans dirilis. Nilai valid:
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. |
|
|
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 |
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 |
sg-bp15ed6xe1yxeycg7**** |
|
| SystemDisk.Encrypted |
string |
No |
Specifies whether to encrypt the system disk. Valid values:
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:
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:
Default value: false. Catatan
This parameter takes effect only when |
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:
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:
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:
|
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:
When you create ECS instances of the preceding instance types, you must configure this parameter. Take note of the following items:
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.