All Products
Search
Document Center

Resource Orchestration Service:ALIYUN::ECS::LaunchTemplate

Last Updated:Jun 26, 2025

ALIYUN::ECS::LaunchTemplate digunakan untuk membuat templat peluncuran yang dapat digunakan untuk membuat instance Elastic Compute Service (ECS).

Sintaksis

{
  "Type": "ALIYUN::ECS::LaunchTemplate",
  "Properties": {
    "LaunchTemplateName": String,
    "VersionDescription": String,
    "ImageId": String,
    "InstanceType": String,
    "SecurityGroupId": String,
    "NetworkType": String,
    "VSwitchId": String,
    "InstanceName": String,
    "Description": String,
    "InternetMaxBandwidthOut": Integer,
    "HostName": String,
    "ZoneId": String,
    "SystemDiskCategory": String,
    "SystemDiskSize": Number,
    "SystemDiskDiskName": String,
    "SystemDiskDescription": String,
    "IoOptimized": String,
    "InternetChargeType": String,
    "UserData": String,
    "KeyPairName": String,
    "RamRoleName": String,
    "AutoReleaseTime": String,
    "SpotStrategy": String,
    "SpotPriceLimit": String,
    "SecurityEnhancementStrategy": String,
    "DiskMappings": List,
    "NetworkInterfaces": List,
    "Tags": List,
    "TemplateTags": List,
    "TemplateResourceGroupId": String,
    "SecurityGroupIds": List,
    "ResourceGroupId": String,
    "SpotDuration": Integer,
    "ImageOwnerAlias": String,
    "Period": Integer,
    "Ipv6AddressCount": Integer,
    "PrivateIpAddress": String,
    "PasswordInherit": Boolean,
    "SystemDiskDeleteWithInstance": Boolean,
    "DeploymentSetId": String,
    "InstanceChargeType": String,
    "SystemDiskPerformanceLevel": String
  }
}

Properti

PropertiTipeDiperlukanDapat DieditDeskripsiBatasan
LaunchTemplateNameStringYaTidakNama dari templat peluncuran. Nama harus memiliki panjang 2 hingga 128 karakter, dan dapat berisi huruf, angka, titik dua (:), garis bawah (_), dan tanda hubung (-). Nama harus dimulai dengan huruf tetapi tidak boleh dimulai dengan http:// atau https://.
VersionDescriptionStringTidakTidakDeskripsi versi templat peluncuran. Deskripsi harus memiliki panjang 2 hingga 128 karakter. Deskripsi harus dimulai dengan huruf tetapi tidak boleh dimulai dengan http:// atau https://.
ImageIdStringTidakTidakID dari image. Tidak ada.
InstanceTypeStringTidakTidakTipe instance. Tidak ada.
SecurityGroupIdStringTidakTidakID dari grup keamanan. Tidak ada.
NetworkTypeStringTidakTidakTipe jaringan dari instance. Nilai yang valid:
  • classic: jaringan klasik
  • vpc: virtual private cloud (VPC)
VSwitchIdStringTidakTidakID dari vSwitch. Properti ini berlaku ketika Anda mengatur properti NetworkType menjadi vpc.
InstanceNameStringTidakTidakNama dari instance. Nama harus memiliki panjang 2 hingga 128 karakter. Nama harus dimulai dengan huruf tetapi tidak boleh dimulai dengan http:// atau https://.
DescriptionStringTidakTidakDeskripsi dari instance. Deskripsi harus memiliki panjang 2 hingga 128 karakter. Deskripsi harus dimulai dengan huruf tetapi tidak boleh dimulai dengan http:// atau https://.
InternetMaxBandwidthOutIntegerTidakTidakBandwidth publik maksimum keluar. Nilai yang valid: 0 hingga 100.

Satuan: Mbit/s.

HostNameStringTidakTidakNama host dari instance.

Nama host tidak boleh dimulai atau diakhiri dengan titik (.) atau tanda hubung (-), atau berisi titik (.) atau tanda hubung (-) berturut-turut.

Nama host harus memenuhi persyaratan berikut:
  • Instance Windows: Nama host harus memiliki panjang 2 hingga 15 karakter, dan dapat berisi huruf, angka, dan tanda hubung (-). Nama host tidak boleh hanya berisi angka.
  • Instance lain seperti instance Linux: Nama host harus memiliki panjang 2 hingga 64 karakter, dan dapat berisi huruf, angka, dan tanda hubung (-).
ZoneIdStringTidakTidakID dari zona tempat instance berada. Tidak ada.
SystemDiskCategoryStringTidakTidakKategori dari disk sistem. Nilai yang valid:
  • cloud: disk dasar
  • cloud_efficiency: disk ultra
  • cloud_ssd: SSD standar
  • ephemeral_ssd: SSD lokal
SystemDiskSizeNumberTidakTidakUkuran dari disk sistem. Nilai yang valid: 20 hingga 500.

Satuan: GB.

SystemDiskDiskNameStringTidakTidakNama dari disk sistem. Nama harus memiliki panjang 2 hingga 128 karakter, dan dapat berisi huruf, angka, titik dua (:), garis bawah (_), dan tanda hubung (-). Nama harus dimulai dengan huruf tetapi tidak boleh dimulai dengan http:// atau https://.
SystemDiskDescriptionStringTidakTidakDeskripsi dari disk sistem. Deskripsi harus memiliki panjang 2 hingga 256 karakter. Deskripsi tidak boleh dimulai dengan http:// atau https://.
IoOptimizedStringTidakTidakMenentukan apakah instance adalah instance dioptimalkan I/O. Nilai yang valid:
  • none: Instance bukan instance dioptimalkan I/O.
  • optimized: Instance adalah instance dioptimalkan I/O.
InternetChargeTypeStringTidakTidakMetode penagihan untuk penggunaan jaringan. Nilai yang valid:
  • PayByBandwidth: bayar per bandwidth
  • PayByTraffic: bayar per transfer data
UserDataStringTidakTidakData pengguna dari instance. Data pengguna harus dienkripsi dalam Base64. Ukuran maksimum data mentah adalah 16 KB.
KeyPairNameStringTidakTidakNama dari pasangan kunci. Properti ini hanya diperlukan untuk instance Linux. Secara default, logon berbasis kata sandi dinonaktifkan untuk instance Linux.
RamRoleNameStringTidakTidakNama dari Peran RAM untuk instance. Tidak ada.
AutoReleaseTimeStringTidakTidakWaktu saat sistem secara otomatis melepaskan instance. Tentukan waktu dalam format ISO 8601 standar dalam yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam UTC.
SpotStrategyStringTidakTidakKebijakan preemption untuk instance bayar sesuai pemakaian.

Properti ini berlaku ketika Anda mengatur properti InstanceChargeType menjadi PostPaid.

Nilai yang valid:

  • NoSpot: Instance dibuat sebagai instance bayar sesuai pemakaian.
  • SpotWithPriceLimit: Instance dibuat sebagai instance preemptible untuk mana Anda menentukan harga maksimum per jam.
  • SpotAsPriceGo: Instance dibuat sebagai instance preemptible yang harganya didasarkan pada harga pasar pada saat pembelian. Harga pasar bisa sama dengan harga instance bayar sesuai pemakaian.
SpotPriceLimitStringTidakTidakHarga maksimum per jam untuk instance. Nilai dari properti ini dapat berisi hingga tiga tempat desimal.
SecurityEnhancementStrategyStringTidakTidakMenentukan apakah akan mengaktifkan penguatan keamanan. Nilai yang valid:
  • Active: mengaktifkan penguatan keamanan.
  • Deactive: menonaktifkan penguatan keamanan.
DiskMappingsListTidakTidakDisk data. Anda dapat melampirkan hingga 16 disk data.

Untuk informasi lebih lanjut, lihat properti DiskMappings.

NetworkInterfacesListTidakTidakAntarmuka jaringan elastis (ENIs). Anda dapat melampirkan hingga delapan ENI.

Untuk informasi lebih lanjut, lihat properti NetworkInterfaces.

TagsListTidakTidakTag dari instance, grup keamanan, disk, dan ENI. Anda dapat menentukan hingga 20 tag untuk instance, grup keamanan, disk, atau ENI.

Untuk informasi lebih lanjut, lihat properti Tags.

TemplateTagsListTidakTidakTag dari templat peluncuran. Anda dapat menambahkan hingga 20 tag.

Untuk informasi lebih lanjut, lihat properti TemplateTags.

TemplateResourceGroupIdStringTidakTidakID dari grup sumber daya tempat templat peluncuran berada. Tidak ada.
SecurityGroupIdsListTidakTidakID satu atau beberapa grup keamanan ke mana Anda ingin menambahkan instance. Nilai dari properti ini bervariasi berdasarkan jumlah maksimum grup keamanan ke mana Anda dapat menambahkan instance.
Catatan Anda tidak dapat menentukan kedua properti SecurityGroupId dan SecurityGroupIds.
ResourceGroupIdStringTidakTidakID dari grup sumber daya tempat instance, perangkat Penyimpanan Blok Elastis (EBS), dan ENI berada. Tidak ada.
SpotDurationIntegerTidakTidakPeriode retensi dari instance preemptible. Nilai yang valid: 0 hingga 6.

Nilai default: 1.

Satuan: jam.

Catatan Jika Anda ingin mengatur nilai menjadi 2 hingga 6, Anda harus mengirimkan tiket.
ImageOwnerAliasStringTidakTidakSumber dari image. Nilai yang valid:
  • system: image publik yang disediakan oleh Alibaba Cloud
  • self: image kustom yang Anda buat
  • others: image bersama dari akun Alibaba Cloud lainnya
  • marketplace: image dari Alibaba Cloud Marketplace
PeriodIntegerTidakTidakDurasi langganan dari templat peluncuran. Properti ini berlaku dan diperlukan ketika Anda mengatur properti InstanceChargeType menjadi PrePaid.

Nilai yang valid: 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36, 48, dan 60.

Satuan: bulan.

Ipv6AddressCountIntegerTidakTidakJumlah alamat IPv6 yang dihasilkan secara acak oleh sistem untuk ENI utama. Nilai yang valid: 1 hingga 10.
PrivateIpAddressStringTidakTidakAlamat IP privat dari instance. Jika Anda mengonfigurasi alamat IP privat untuk instance ECS tipe VPC, Anda harus memilih alamat IP yang tidak digunakan dari blok CIDR vSwitch.
PasswordInheritBooleanTidakTidakMenentukan apakah akan menggunakan kata sandi preset dari image. Nilai yang valid:
  • true
  • false
Catatan Anda hanya perlu menentukan salah satu properti PasswordInherit atau Password.
SystemDiskDeleteWithInstanceBooleanTidakTidakMenentukan apakah akan melepaskan disk sistem ketika instance dilepaskan. Nilai default: true. Nilai yang valid:
  • true
  • false
DeploymentSetIdStringTidakTidakID dari set penyebaran. Tidak ada.
InstanceChargeTypeStringTidakTidakMetode penagihan dari instance. Nilai yang valid:
  • PrePaid: langganan
  • PostPaid: bayar sesuai pemakaian
SystemDiskPerformanceLevelStringTidakTidakTingkat performa (PL) dari ESSD yang digunakan sebagai disk sistem. Nilai default: PL0. Nilai yang valid:
  • PL0: ESSD dapat memberikan hingga 10.000 operasi I/O baca/tulis acak.
  • PL1: ESSD dapat memberikan hingga 50.000 operasi I/O baca/tulis acak.
  • PL2: ESSD dapat memberikan hingga 100.000 operasi I/O baca/tulis acak.
  • PL3: ESSD dapat memberikan hingga 1.000.000 operasi I/O baca/tulis acak.

Sintaksis DiskMappings

"DiskMappings": [
  {
    "Category": String,
    "DiskName": String,
    "Description": String,
    "SnapshotId": String,
    "Size": String,
    "Encrypted": String,
    "DeleteWithInstance": String,
    "PerformanceLevel": String
  }
]

Properti DiskMappings

PropertiTipeDiperlukanDapat DieditDeskripsiBatasan
CategoryStringTidakTidakKategori dari disk data. Nilai yang valid:
  • cloud: disk dasar
  • cloud_efficiency: disk ultra
  • cloud_ssd: SSD standar
  • ephemeral_ssd: SSD lokal
DiskNameStringTidakTidakNama dari disk data. Nama harus memiliki panjang 2 hingga 128 karakter, dan dapat berisi huruf, angka, titik dua(:), garis bawah (_), dan tanda hubung (-). Nama harus dimulai dengan huruf tetapi tidak boleh dimulai dengan http:// atau https://.
DescriptionStringTidakTidakDeskripsi dari disk data. Deskripsi harus memiliki panjang 2 hingga 256 karakter. Nama tidak boleh dimulai dengan http:// atau https://.
SnapshotIdStringTidakTidakID dari snapshot yang digunakan untuk membuat disk data. Tidak ada.
SizeStringTidakTidakUkuran dari disk sistem.

Nilai yang valid:

  • Nilai yang valid jika Anda mengatur properti Category menjadi cloud: 5 hingga 2000.
  • Nilai yang valid jika Anda mengatur properti Category menjadi cloud_efficiency: 20 hingga 32768.
  • Nilai yang valid jika Anda mengatur properti Category menjadi cloud_ssd: 20 hingga 32768.
  • Nilai yang valid jika Anda mengatur properti Category menjadi ephemeral_ssd: 5 hingga 800.

Satuan: GB.

EncryptedBooleanTidakTidakMenentukan apakah akan mengenkripsi disk data. Nilai yang valid:
  • true
  • false
DeleteWithInstanceBooleanTidakTidakMenentukan apakah akan melepaskan disk data ketika instance dilepaskan. Nilai yang valid:
  • true
  • false
PerformanceLevelStringTidakTidakPL dari ESSD yang digunakan sebagai disk data. Nilai default: PL0. Nilai yang valid:
  • PL0: ESSD dapat memberikan hingga 10.000 operasi I/O baca/tulis acak.
  • PL1: ESSD dapat memberikan hingga 50.000 operasi I/O baca/tulis acak.
  • PL2: ESSD dapat memberikan hingga 100.000 operasi I/O baca/tulis acak.
  • PL3: ESSD dapat memberikan hingga 1.000.000 operasi I/O baca/tulis acak.

Sintaksis NetworkInterfaces

"NetworkInterfaces": [
  {
    "PrimaryIpAddress": String,
    "VSwitchId": String,
    "SecurityGroupId": String,
    "NetworkInterfaceName": String,
    "Description": String
  }
]

Properti NetworkInterfaces

PropertiTipeDiperlukanDapat DieditDeskripsiBatasan
PrimaryIpAddressStringTidakTidakAlamat IP privat utama dari ENI. Tidak ada.
VSwitchIdStringTidakTidakID dari vSwitch tempat ENI berada. Tidak ada.
SecurityGroupIdStringTidakTidakID dari grup keamanan tempat ENI berada. Tidak ada.
NetworkInterfaceNameStringTidakTidakNama dari ENI. Tidak ada.
DescriptionStringTidakTidakDeskripsi dari ENI. Deskripsi harus memiliki panjang 2 hingga 256 karakter. Deskripsi tidak boleh dimulai dengan http:// atau https://.

Sintaksis Tags

"Tags": [
  {
    "Value": String,
    "Key": String
  }
]

Properti Tags

PropertiTipeDiperlukanDapat DieditDeskripsiBatasan
KeyStringTidakTidakKunci dari tag. Kunci harus memiliki panjang 1 hingga 128 karakter, dan tidak boleh berisi http:// atau https://. Kunci tidak boleh dimulai dengan aliyun atau acs:.
ValueStringTidakTidakNilai dari tag. Nilai dapat memiliki panjang hingga 128 karakter, dan tidak boleh berisi http:// atau https://. Nilai tidak boleh dimulai dengan aliyun atau acs:.

Sintaksis TemplateTags

"TemplateTags": [
  {
    "Value": String,
    "Key": String
  }
]

Properti TemplateTags

PropertiTipeDiperlukanDapat DieditDeskripsiBatasan
KeyStringTidakTidakKunci dari tag. Kunci harus memiliki panjang 1 hingga 128 karakter, dan tidak boleh berisi http:// atau https://. Kunci tidak boleh dimulai dengan aliyun atau acs:.
ValueStringTidakTidakNilai dari tag. Nilai dapat memiliki panjang hingga 128 karakter, dan tidak boleh berisi http:// atau https://. Nilai tidak boleh dimulai dengan aliyun atau acs:.

Nilai kembali

Fn::GetAtt

  • LaunchTemplateId: ID templat peluncuran.
  • LaunchTemplateName: Nama templat peluncuran.
  • DefaultVersionNumber: Nomor versi default templat peluncuran.
  • LatestVersionNumber: Nomor versi terbaru templat peluncuran.

Contoh

  • YAML format

    ROSTemplateFormatVersion: '2015-09-01'
    Description: Test ECS LaunchTemplate
    Parameters:
      VSwitchId:
        Type: String
        AssociationProperty: ALIYUN::ECS::VSwitch::VSwitchId
      SecurityGroupId:
        AssociationProperty: ALIYUN::ECS::SecurityGroup::SecurityGroupId
        Type: String
    Resources:
      LaunchTemplate:
        Type: ALIYUN::ECS::LaunchTemplate
        Properties:
          LaunchTemplateName: mytest
          VersionDescription: Test create LaunchTemplate
          ImageId: centos_7
          InstanceType: ecs.c5.large
          SystemDiskCategory: cloud_essd
          SecurityGroupId:
            Ref: SecurityGroupId
          VSwitchId:
            Ref: VSwitchId
    Outputs: {}
  • JSON format

    {
      "ROSTemplateFormatVersion": "2015-09-01",
      "Description": "Test ECS LaunchTemplate",
      "Parameters": {
        "VSwitchId": {
          "Type": "String",
          "AssociationProperty": "ALIYUN::ECS::VSwitch::VSwitchId"
        },
        "SecurityGroupId": {
          "AssociationProperty": "ALIYUN::ECS::SecurityGroup::SecurityGroupId",
          "Type": "String"
        }
      },
      "Resources": {
        "LaunchTemplate": {
          "Type": "ALIYUN::ECS::LaunchTemplate",
          "Properties": {
            "LaunchTemplateName": "mytest",
            "VersionDescription": "Test create LaunchTemplate",
            "ImageId": "centos_7",
            "InstanceType": "ecs.c5.large",
            "SystemDiskCategory": "cloud_essd",
            "SecurityGroupId": {
              "Ref": "SecurityGroupId"
            },
            "VSwitchId": {
              "Ref": "VSwitchId"
            }
          }
        }
      },
      "Outputs": {
      }
    }

Untuk lebih banyak contoh, kunjungi LaunchTemplate.json dan LaunchTemplate.yml. Dalam contoh-contoh tersebut, jenis sumber daya ALIYUN::ECS::LaunchTemplate dan ALIYUN::ECS::AutoProvisioningGroup digunakan.