全部产品
Search
文档中心

Resource Orchestration Service:ALIYUN::ECS::InstanceGroup

更新时间:Jul 06, 2025

ALIYUN::ECS::InstanceGroup digunakan untuk membuat instance Elastic Compute Service (ECS) dengan konfigurasi yang sama.

Sintaksis

{
  "Type": "ALIYUN::ECS::InstanceGroup",
  "Properties": {
    "DedicatedHostId": String,
    "ResourceGroupId": String,
    "SystemDiskDescription": String,
    "InstanceChargeType": String,
    "RamRoleName": String,
    "SystemDiskPerformanceLevel": String,
    "ImageId": String,
    "SystemDiskDiskName": String,
    "Tags": List,
    "HostName": String,
    "LaunchTemplateName": String,
    "VSwitchId": String,
    "Period": Number,
    "ZoneIds": List,
    "LaunchTemplateId": String,
    "DeletionProtection": Boolean,
    "SecurityGroupIds": List,
    "SecurityEnhancementStrategy": String,
    "InternetChargeType": String,
    "InstanceName": String,
    "DeploymentSetId": String,
    "SubscriptionDeletionForce": Boolean,
    "InternetMaxBandwidthOut": Integer,
    "VpcId": String,
    "LaunchTemplateVersion": String,
    "PeriodUnit": String,
    "AutoReleaseTime": String,
    "PrivateIpAddress": String,
    "Description": String,
    "DiskMappings": List,
    "SystemDiskSize": Number,
    "UserData": String,
    "AutoRenew": String,
    "Ipv6Addresses": List,
    "MaxAmount": Integer,
    "SystemDiskAutoSnapshotPolicyId": String,
    "Ipv6AddressCount": Integer,
    "NetworkType": String,
    "SpotPriceLimit": String,
    "InstanceType": String,
    "AllocatePublicIP": Boolean,
    "SpotStrategy": String,
    "Password": String,
    "PasswordInherit": Boolean,
    "AutoRenewPeriod": Number,
    "KeyPairName": String,
    "IoOptimized": String,
    "ZoneId": String,
    "HpcClusterId": String,
    "SecurityGroupId": String,
    "SystemDiskCategory": String,
    "EniMappings": List,
    "SystemDiskProvisionedIops": Integer,
    "SystemDiskBurstingEnabled": Boolean,
    "SpotInterruptionBehavior": String,
    "SpotDuration": Integer,
    "UpdatePolicy": String,
    "SystemDiskEncrypted": String,
    "SystemDiskEncryptAlgorithm": String,
    "SystemDiskStorageClusterId": String,
    "SystemDiskKMSKeyId": String,
    "CreditSpecification": String,
    "PrivatePoolOptions": Map,
    "StorageSetId": String,
    "HttpTokens": String,
    "HttpEndpoint": String,
    "Tenancy": String,
    "StorageSetPartitionNumber": Integer,
    "DeploymentSetGroupNo": Integer,
    "Affinity": String,
    "UseAdditionalService": Boolean,
    "ImageFamily": String,
    "DeletionForce": Boolean,
    "UniqueSuffix": Boolean,
    "NetworkOptions": Map,
    "CpuOptions": Map,
    "NetworkInterfaceQueueNumber": Integer,
    "HostNames": List,
    "ImageOptions": Map,
    "SecurityOptions": Map,
    "SchedulerOptions": Map
  }
}

Properti

Properti

Tipe

Diperlukan

Dapat Diedit

Deskripsi

Kendala

ResourceGroupId

String

Tidak

Ya

ID grup sumber daya tempat instance ECS berada.

Tidak ada.

SpotInterruptionBehavior

String

Tidak

Tidak

Mode interupsi untuk instance preemptible.

Atur nilai menjadi Terminate, yang menentukan bahwa sistem langsung melepaskan instance preemptible. Nilai default: Terminate.

SpotDuration

Integer

Tidak

Tidak

Periode perlindungan untuk instance preemptible.

Nilai valid: 0 hingga 6.

Unit: jam.

Nilai valid:

  • 0: Jika Anda mengatur properti ini ke 0, instance preemptible tidak memiliki periode perlindungan.

  • 2 hingga 6: Periode perlindungan ini dalam pratinjau undangan. Jika Anda ingin mengatur properti ini ke salah satu nilai tersebut, kirimkan tiket.

  • 1 (default).

HpcClusterId

String

Tidak

Ya

ID kluster Elastic High Performance Computing (E-HPC) tempat instance ECS berada.

Pembaruan pada properti ini hanya berlaku untuk instance ECS baru yang ditambahkan.

MaxAmount

Integer

Ya

Ya

Jumlah instance ECS yang dapat dibuat sekaligus.

Nilai valid: 1 hingga 1000.

Catatan

Jika Anda meningkatkan atau menurunkan nilai MaxAmount saat memperbarui tumpukan yang merujuk pada properti ini, jumlah instance ECS akan bertambah atau berkurang berdasarkan nilai baru. Sebagai contoh, jika Anda mengubah nilai MaxAmount dari 2 menjadi 5, tiga instance ECS akan ditambahkan.

Description

String

Tidak

Ya

Deskripsi.

Deskripsi bisa mencapai 256 karakter.

Catatan

Pembaruan pada properti ini hanya berlaku untuk instance ECS baru yang ditambahkan.

InstanceType

String

Ya

Ya

Tipe instance ECS.

Untuk informasi lebih lanjut, lihat Ikhtisar keluarga instance.

Catatan

Pembaruan pada properti ini berlaku untuk instance yang ada hanya ketika UpdatePolicy diatur ke ForAllInstances. Dalam kasus lain, pembaruan pada properti ini hanya berlaku untuk instance baru yang ditambahkan.

ImageId

String

Tidak

Ya

ID gambar yang digunakan untuk memulai instance ECS. Anda dapat menggunakan gambar publik, gambar kustom, atau gambar dari Alibaba Cloud Marketplace.

Untuk menentukan gambar publik, Anda dapat memasukkan ID gambar parsial alih-alih ID gambar lengkap. Gambar publik mendukung pencocokan fuzzy. Contoh:

  • Jika Anda menentukan Ubuntu, sistem akan mencocokkannya dengan ID gambar berikut: ubuntu_16_0402_64_20G_alibase_20170818.vhd.

  • Jika Anda menentukan ubuntu1432, sistem akan mencocokkannya dengan ID gambar berikut: ubuntu_14_0405_32_40G_alibase_20170711.vhd.

Untuk informasi lebih lanjut, lihat Parameter permintaan.

Catatan

Pembaruan pada properti ini berlaku untuk instance yang ada hanya ketika UpdatePolicy diatur ke ForAllInstances. Dalam kasus lain, pembaruan pada properti ini hanya berlaku untuk instance baru yang ditambahkan.

SecurityGroupId

String

Tidak

Tidak

ID grup keamanan tempat instance ECS berada. Instance dalam grup keamanan yang sama dapat berkomunikasi satu sama lain.

Anda tidak dapat menentukan SecurityGroupId dan SecurityGroupIds secara bersamaan.

SecurityGroupIds

List

Tidak

Tidak

ID grup keamanan tempat instance ECS berada.

Anda tidak dapat menentukan SecurityGroupId dan SecurityGroupIds secara bersamaan.

Untuk informasi lebih lanjut, lihat Grup Keamanan.

SecurityEnhancementStrategy

String

Tidak

Tidak

Menentukan apakah akan mengaktifkan penguatan keamanan.

Nilai valid:

  • Aktif: mengaktifkan penguatan keamanan. Nilai ini hanya valid untuk gambar publik.

  • Nonaktif: menonaktifkan penguatan keamanan. Nilai ini valid untuk semua jenis gambar.

InstanceName

String

Tidak

Tidak

Nama instance ECS.

Nama dapat mencapai 128 karakter, dan dapat berisi huruf, angka, garis bawah (_), titik (.), dan tanda hubung (-).

Nama harus dalam format name_prefix[begin_number,bits]name_suffix. Nama setiap instance ECS harus unik. Untuk informasi lebih lanjut, lihat Parameter Permintaan.

Password

String

Tidak

Ya

Kata sandi yang ingin Anda gunakan untuk masuk ke instance ECS.

Kata sandi harus memiliki panjang 8 hingga 30 karakter. Harus berisi minimal tiga dari jenis karakter berikut: huruf besar, huruf kecil, angka, dan karakter khusus. Karakter khusus berikut didukung: : ( ) ` ~ ! @ # $ % ^ & * - + = | { } [ ] : ; ‘ < > , . ? /.

Jika Anda menentukan Password, kami sarankan Anda memanggil API Layanan Orkestrasi Sumber Daya (ROS) menggunakan HTTPS untuk mencegah terpaparnya kata sandi Anda.

Catatan

Pembaruan pada properti ini berlaku untuk instance yang ada hanya ketika UpdatePolicy diatur ke ForAllInstances. Dalam kasus lain, pembaruan pada properti ini hanya berlaku untuk instance baru yang ditambahkan.

PasswordInherit

Boolean

Tidak

Tidak

Menentukan apakah akan menggunakan kata sandi preset dari gambar.

Nilai valid:

  • true

  • false

Catatan

Jika Anda mengatur properti ini ke true, Anda harus membiarkan Password kosong dan memastikan bahwa gambar yang dipilih memiliki kata sandi preset.

ZoneIds

List

Tidak

Tidak

Zona.

Tidak ada.

HostName

String

Tidak

Tidak

Nama host.

Nama host harus memiliki minimal dua karakter. Tidak boleh dimulai atau diakhiri dengan titik (.) atau tanda hubung (-). Tidak boleh berisi titik (.) atau tanda hubung (-) berturut-turut.

Untuk informasi lebih lanjut, lihat Parameter Permintaan.

AllocatePublicIP

Boolean

Tidak

Tidak

Menentukan apakah akan menetapkan alamat IP publik.

Jika Anda mengatur InternetMaxBandwidthOut ke 0, sistem tidak akan menetapkan alamat IP publik.

Nilai valid:

  • true (default)

  • false

AutoReleaseTime

String

Tidak

Tidak

Waktu ketika sistem secara otomatis melepaskan instance ECS.

Tentukan waktu dalam standar ISO 8601 dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam jangka waktu tiga tahun dari waktu pembuatan instance ECS.

PrivateIpAddress

String

Tidak

Tidak

Alamat IP privat instance ECS.

Jika Anda menentukan alamat IP privat untuk instance ECS dalam virtual private cloud (VPC), Anda harus memilih alamat IP idle dari blok CIDR vSwitch.

Catatan

Jika Anda menentukan PrivateIpAddress, Anda harus mengatur MaxAmount ke 1.

DiskMappings

List

Tidak

Ya

Disk data yang ingin Anda buat untuk instance ECS.

Anda dapat membuat hingga 16 disk data.

Jika Anda mengubah nilai properti ini, instance ECS yang ada tidak terpengaruh. Nilai baru berlaku untuk instance ECS baru yang ditambahkan.

Untuk informasi lebih lanjut, lihat Properti DiskMappings.

Catatan

Pembaruan pada properti ini hanya berlaku untuk instance ECS baru yang ditambahkan.

InternetChargeType

String

Tidak

Ya

Metode penagihan untuk penggunaan internet.

Nilai valid:

  • PayByBandwidth: bayar per bandwidth

  • PayByTraffic (default): bayar per transfer data

Catatan

Pembaruan pada properti ini berlaku untuk instance yang ada hanya ketika UpdatePolicy diatur ke ForAllInstances. Dalam kasus lain, pembaruan pada properti ini hanya berlaku untuk instance baru yang ditambahkan.

InternetMaxBandwidthOut

Integer

Tidak

Ya

Bandwidth publik maksimum keluar.

Nilai valid: 0 hingga 100.

Unit: Mbit/s.

Nilai default: 0.

Catatan

Pembaruan pada properti ini berlaku untuk instance yang ada hanya ketika UpdatePolicy diatur ke ForAllInstances. Dalam kasus lain, pembaruan pada properti ini hanya berlaku untuk instance baru yang ditambahkan.

SystemDiskProvisionedIops

Integer

Tidak

Ya

IOPS yang disediakan untuk disk sistem.

Tidak ada.

SystemDiskBurstingEnabled

Boolean

Tidak

Ya

Menentukan apakah akan mengaktifkan mode burst untuk disk sistem.

Nilai valid:

  • true

  • false (default)

SubscriptionDeletionForce

Boolean

Tidak

Tidak

Properti ini hanya berlaku untuk instance berlangganan. Jika Anda mengatur properti ini ke true untuk instance berlangganan, instance tersebut akan diubah menjadi pay-as-you-go sebelum instance dipaksa dihapus. Jika Anda mengatur properti ini ke false untuk instance berlangganan, instance tidak akan dipaksa dihapus. Properti ini melibatkan biaya tambahan. Berhati-hatilah saat menentukan properti ini.

Tidak ada.

IoOptimized

String

Tidak

Tidak

Menentukan apakah akan membuat instance yang dioptimalkan I/O.

Nilai valid:

  • none: tidak membuat instance yang dioptimalkan I/O.

  • optimized (default): membuat instance yang dioptimalkan I/O.

SystemDiskCategory

String

Tidak

Ya

Kategori disk sistem.

Nilai valid:

  • cloud: basic disk

  • cloud_efficiency: ultra disk

  • cloud_ssd: standard SSD

  • cloud_essd: Enterprise SSD (ESSD)

  • ephemeral_ssd: local SSD

Catatan

Pembaruan pada properti ini berlaku untuk instance yang ada hanya ketika UpdatePolicy diatur ke ForAllInstances. Dalam kasus lain, pembaruan pada properti ini hanya berlaku untuk instance baru yang ditambahkan.

SystemDiskDescription

String

Tidak

Ya

Deskripsi disk sistem.

Pembaruan pada properti ini hanya berlaku untuk instance ECS baru yang ditambahkan.

SystemDiskDiskName

String

Tidak

Ya

Nama disk sistem.

Pembaruan pada properti ini hanya berlaku untuk instance ECS baru yang ditambahkan.

SystemDiskSize

Number

Tidak

Ya

Ukuran disk sistem.

Nilai valid: 40 hingga 500.

Unit: GB.

Jika Anda menggunakan gambar kustom untuk membuat disk sistem, Anda harus memastikan bahwa ukuran disk sistem lebih besar dari ukuran gambar kustom.

Catatan

Pembaruan pada properti ini berlaku untuk instance yang ada hanya ketika UpdatePolicy diatur ke ForAllInstances. Dalam kasus lain, pembaruan pada properti ini hanya berlaku untuk instance baru yang ditambahkan.

Tags

List

Tidak

Ya

Tag kustom yang ingin Anda tambahkan ke instance ECS.

Anda dapat menambahkan hingga 20 tag dalam format berikut: [{"Key":"tagKey","Value":"tagValue"},{"Key":"tagKey2","Value":"tagValue2"}].

Untuk informasi lebih lanjut, lihat Properti Tags.

UserData

String

Tidak

Ya

Data pengguna yang Anda tentukan saat membuat instance ECS.

Data pengguna bisa mencapai 16 KB. Anda tidak perlu mengonversi data ke string Base64. Jika data berisi karakter khusus, Anda harus menambahkan karakter escape (\) sebelum setiap karakter khusus.

Catatan

Pembaruan pada properti ini berlaku untuk instance yang ada hanya ketika UpdatePolicy diatur ke ForAllInstances. Dalam kasus lain, pembaruan pada properti ini hanya berlaku untuk instance baru yang ditambahkan.

ZoneId

String

Tidak

Tidak

ID zona.

Tidak ada.

VpcId

String

Tidak

Tidak

ID VPC.

Tidak ada.

VSwitchId

String

Tidak

Tidak

ID vSwitch.

Tidak ada.

KeyPairName

String

Tidak

Ya

Nama pasangan kunci yang ingin Anda gunakan untuk terhubung ke instance ECS.

Untuk instance ECS Windows, Anda dapat mengabaikan KeyPairName. Secara default, properti ini kosong.

Jika Anda menentukan KeyPairName, nilai Password tetap digunakan untuk instance ECS. Namun, log masuk berbasis kata sandi dinonaktifkan untuk instance ECS Linux.

Catatan

Pembaruan pada properti ini hanya berlaku untuk instance ECS baru yang ditambahkan.

RamRoleName

String

Tidak

Ya

Nama peran Resource Access Management (RAM) untuk instance ECS.

Anda dapat memanggil operasi ListRoles untuk menanyakan nama peran RAM.

SpotPriceLimit

String

Tidak

Tidak

Harga maksimum per jam untuk instance ECS.

Nilai properti ini dapat berisi hingga tiga tempat desimal. Properti ini berlaku saat SpotStrategy diatur ke SpotWithPriceLimit.

SpotStrategy

String

Tidak

Ya

Kebijakan penawaran untuk instance pay-as-you-go.

Properti ini berlaku saat InstanceChargeType diatur ke PostPaid.

Nilai valid:

  • NoSpot (default): Instance dibuat sebagai instance pay-as-you-go reguler.

  • SpotWithPriceLimit: Instance dibuat sebagai instance preemptible dengan harga maksimum per jam yang ditentukan pengguna.

  • SpotAsPriceGo: Instans ini dibuat sebagai instans preemptible dengan harga penawaran yang didasarkan pada harga pasar pada saat pembelian. Harga pasar bisa mencapai harga pay-as-you-go.

DedicatedHostId

String

Tidak

Tidak

ID host khusus.

Tidak ada.

LaunchTemplateName

String

Tidak

Ya

Nama template peluncuran.

Tidak ada.

PeriodUnit

String

Tidak

Ya

Satuan siklus penagihan instance ECS.

Nilai valid:

  • Minggu

  • Bulan (default)

Catatan

Pembaruan pada properti ini hanya berlaku untuk instance ECS baru yang ditambahkan.

AutoRenewPeriod

Number

Tidak

Ya

Periode perpanjangan otomatis.

Anda harus menentukan properti ini saat AutoRenew diatur ke True.

Nilai valid:

  • 1 (default)

  • 2

  • 3

  • 6

  • 12

Catatan

Pembaruan pada properti ini hanya berlaku untuk instance ECS baru yang ditambahkan.

AutoRenew

String

Tidak

Ya

Menentukan apakah akan mengaktifkan perpanjangan otomatis.

Properti ini berlaku saat InstanceChargeType diatur ke PrePaid.

Nilai valid:

  • True

  • False (default)

Catatan

Pembaruan pada properti ini hanya berlaku untuk instance ECS baru yang ditambahkan.

InstanceChargeType

String

Tidak

Ya

Metode penagihan instance ECS.

Nilai valid:

  • PrePaid: langganan

    Catatan

    Jika Anda mengatur properti ini ke PrePaid, Anda harus memastikan bahwa akun Anda mendukung metode pembayaran saldo atau kredit. Jika akun Anda tidak mendukung salah satu metode pembayaran, kesalahan InvalidPayMethod akan dikembalikan.

  • PostPaid (default): pay-as-you-go

Catatan

Pembaruan pada properti ini hanya berlaku untuk instance ECS baru yang ditambahkan.

EniMappings

List

Tidak

Ya

Elastic network interfaces (ENI) yang ingin Anda lampirkan ke instance ECS.

Anda dapat melampirkan hingga satu ENI ke instance.

Untuk informasi lebih lanjut, lihat Properti EniMappings.

LaunchTemplateId

String

Tidak

Ya

ID template peluncuran.

Tidak ada.

LaunchTemplateVersion

String

Tidak

Ya

Versi template peluncuran.

Jika Anda tidak menentukan versi, versi default yang digunakan.

Period

Number

Tidak

Ya

Durasi langganan instance ECS.

Anda harus menentukan properti ini saat InstanceChargeType diatur ke PrePaid.

Jika Anda menentukan DedicatedHostId, nilai Period harus dalam periode langganan host khusus.

  • Nilai valid untuk Period saat PeriodUnit diatur ke Minggu: 1 hingga 4.

  • Nilai valid untuk Period saat PeriodUnit diatur ke Bulan: 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36, 48, dan 60.

Catatan

Pembaruan pada properti ini hanya berlaku untuk instance ECS baru yang ditambahkan.

NetworkType

String

Tidak

Tidak

Tipe jaringan instance ECS.

Nilai valid:

  • vpc

  • classic (default)

DeletionProtection

Boolean

Tidak

Ya

Properti perlindungan penghapusan instance ECS. Anda dapat menggunakan properti ini untuk menentukan apakah Anda dapat menghapus instance ECS menggunakan konsol ECS atau operasi DeleteInstance.

Nilai valid:

  • true

  • false

DeploymentSetId

String

Tidak

Ya

ID set penyebaran.

Pembaruan pada properti ini hanya berlaku untuk instance ECS baru yang ditambahkan.

Ipv6AddressCount

Integer

Tidak

Ya

Jumlah alamat IPv6 yang dihasilkan secara acak untuk ENI.

Anda tidak dapat menentukan Ipv6Addresses dan Ipv6AddressCount secara bersamaan.

Catatan

Pembaruan pada properti ini hanya berlaku untuk instance ECS baru yang ditambahkan.

Ipv6Addresses

List

Tidak

Ya

Alamat IPv6 yang ingin Anda tetapkan ke ENI.

Anda dapat menentukan hingga satu alamat IPv6. Jika Anda mengubah nilai properti ini, instance ECS yang ada tidak terpengaruh. Anda tidak dapat menentukan Ipv6Addresses dan Ipv6AddressCount secara bersamaan.

Catatan

Pembaruan pada properti ini hanya berlaku untuk instance ECS baru yang ditambahkan.

SystemDiskAutoSnapshotPolicyId

String

Tidak

Ya

ID kebijakan snapshot otomatis yang ingin Anda gunakan untuk disk sistem.

Tidak ada.

SystemDiskPerformanceLevel

String

Tidak

Ya

Tingkat performa (PL) ESSD yang ingin Anda gunakan sebagai disk sistem.

Nilai valid:

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

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

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

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

Untuk informasi lebih lanjut tentang cara memilih PL dari ESSD, lihat ESSDs.

UpdatePolicy

String

Tidak

Ya

Kebijakan pembaruan yang ingin Anda gunakan untuk instance ECS.

Nilai valid:

  • ForNewInstance (default): Kebijakan pembaruan berlaku untuk instance ECS baru yang ditambahkan.

  • ForAllInstances: Kebijakan pembaruan berlaku untuk semua instance ECS.

SystemDiskEncrypted

String

Tidak

Ya

Menentukan apakah akan mengenkripsi disk sistem.

Nilai valid:

  • true

  • false

SystemDiskEncryptAlgorithm

String

Tidak

Ya

Algoritma enkripsi yang ingin Anda gunakan untuk disk sistem.

Nilai valid:

  • AES-256

  • SM4-128

SystemDiskStorageClusterId

String

Tidak

Ya

ID kluster penyimpanan blok khusus tempat disk sistem berada.

Tidak ada.

SystemDiskKMSKeyId

String

Tidak

Ya

ID kunci Key Management Service (KMS) yang ingin Anda gunakan untuk disk sistem.

Tidak ada.

CreditSpecification

String

Tidak

Ya

Mode performa instance burstable.

Nilai valid:

  • Standard: mode standar. Untuk informasi lebih lanjut, lihat bagian "Standard mode" dari topik Overview.

  • Unlimited: mode tanpa batas. Untuk informasi lebih lanjut, lihat bagian "Unlimited mode" dari topik Overview.

PrivatePoolOptions

Map

Tidak

Tidak

Opsi kolam pribadi yang ingin digunakan untuk memulai instance ECS.

Untuk informasi lebih lanjut, lihat properti PrivatePoolOptions.

StorageSetId

String

Tidak

Tidak

ID set penyimpanan.

Tidak ada.

HttpTokens

String

Tidak

Ya

Menentukan apakah akan secara paksa menggunakan mode pengerasan keamanan (IMDSv2) untuk mengakses metadata instans.

Nilai valid:

  • optional (default): tidak secara paksa menggunakan mode pengerasan keamanan (IMDSv2) untuk mengakses metadata instans.

  • required: secara paksa menggunakan mode pengerasan keamanan (IMDSv2) untuk mengakses metadata instans. Setelah Anda mengatur properti ini ke required, Anda tidak dapat mengakses metadata instans dalam mode normal.

Catatan

Untuk informasi lebih lanjut tentang mode akses metadata instans, lihat Metadata Instans.

HttpEndpoint

String

Tidak

Ya

Menentukan apakah akan mengaktifkan saluran akses untuk metadata instans.

Nilai valid:

  • enabled (default)

  • disabled

Catatan

Untuk informasi lebih lanjut tentang mode akses metadata instans, lihat Metadata Instans.

Tenancy

String

Tidak

Tidak

Menentukan apakah akan membuat instans pada host khusus.

Nilai valid:

  • default (default): tidak membuat instans pada host khusus.

  • host: membuat instans pada host khusus. Jika Anda tidak menentukan DedicatedHostId, Alibaba Cloud secara otomatis memilih host khusus untuk instans.

StorageSetPartitionNumber

Integer

Tidak

Tidak

Jumlah maksimum partisi dalam set penyimpanan.

Anda harus mengatur properti ini ke nilai yang lebih besar atau sama dengan 2.

DeploymentSetGroupNo

Integer

Tidak

Tidak

Nomor grup set penyebaran tempat instans akan diterapkan. Jika set penyebaran yang ditentukan oleh DeploymentSetId menggunakan strategi kelompok ketersediaan tinggi (AvailabilityGroup), Anda dapat menggunakan DeploymentSetGroupNo untuk menentukan grup penyebaran dalam set penyebaran.

Nilai valid: 1 hingga 7.

Affinity

String

Tidak

Tidak

Menentukan apakah akan mengaitkan instans pada host khusus dengan host khusus tersebut.

Nilai valid:

  • default: tidak mengaitkan instans pada host khusus dengan host khusus. Saat Anda memulai ulang instans yang dihentikan dalam mode ekonomis dan host asli instans memiliki sumber daya yang tidak mencukupi, instans secara otomatis diterapkan ke host khusus lain dalam pool sumber daya penyebaran otomatis.

  • host: mengaitkan instans pada host khusus dengan host khusus. Saat Anda memulai ulang instans yang dihentikan dalam mode ekonomis, instans tetap berada di host aslinya. Jika host asli memiliki sumber daya yang tidak mencukupi, Anda tidak dapat memulai ulang instans.

UseAdditionalService

Boolean

Tidak

Tidak

Menentukan apakah akan menggunakan konfigurasi sistem tambahan untuk mesin virtual. Alibaba Cloud menyediakan konfigurasi sistem NTP dan KMS untuk Windows serta konfigurasi sistem NTP dan YUM untuk Linux.

Nilai valid:

  • true

  • false

ImageFamily

String

Tidak

Tidak

Nama keluarga gambar.

Anda dapat menentukan properti ini untuk menanyakan gambar tersedia terbaru yang termasuk dalam keluarga gambar yang ditentukan dan menggunakan gambar tersebut untuk membuat instans.

  • Jika Anda menentukan ImageId, Anda tidak dapat menentukan ImageFamily.

  • Jika Anda tidak menentukan ImageId tetapi menggunakan LaunchTemplateId atau LaunchTemplateName untuk menentukan template peluncuran yang memiliki ImageId yang ditentukan, Anda tidak dapat menentukan ImageFamily.

  • Jika Anda tidak menentukan ImageId tetapi menggunakan LaunchTemplateId atau LaunchTemplateName untuk menentukan template peluncuran yang tidak memiliki ImageId yang ditentukan, Anda dapat menentukan ImageFamily.

  • Jika Anda tidak menentukan ImageId dan tidak menentukan LaunchTemplateId atau LaunchTemplateName, Anda dapat menentukan ImageFamily.

Catatan

Untuk informasi lebih lanjut tentang keluarga gambar yang terkait dengan gambar resmi Alibaba Cloud, lihat Ikhtisar.

DeletionForce

Boolean

Tidak

Tidak

Menentukan apakah akan memaksa menghapus instans.

Nilai default: false.  

UniqueSuffix

Boolean

Tidak

Tidak

Menentukan apakah akan menambahkan akhiran urutan secara otomatis ke nilai HostName dan InstanceName saat Anda membuat beberapa instans.

Akhiran urutan berkisar dari 001 hingga 999. Nilai valid:

  • true

  • false (default)

Saat Anda menentukan nilai HostName atau InstanceName dalam format name_prefix[begin_number,bits] yang tidak berisi akhiran yang ditentukan oleh name_suffix, UniqueSuffix tidak berlaku. Nama hanya diurutkan dalam urutan yang ditentukan.

Untuk informasi lebih lanjut, lihat Konfigurasi nama atau hostname berurutan untuk beberapa instans.

NetworkOptions

Map

Tidak

Tidak

Opsi jaringan.

Untuk informasi lebih lanjut, lihat Properti NetworkOptions.

CpuOptions

Map

Tidak

Tidak

Opsi CPU.

Untuk informasi lebih lanjut, lihat Properti CpuOptions.

NetworkInterfaceQueueNumber

Integer

Tidak

Tidak

Jumlah antrian yang didukung oleh ENI utama.

Perhatikan hal-hal berikut:

  • Nilai properti ini tidak boleh melebihi jumlah maksimum antrian per ENI yang diizinkan untuk tipe instans.

  • Jumlah total antrian untuk semua ENI pada instans tidak boleh melebihi kuota antrian untuk tipe instans. Untuk menanyakan jumlah maksimum antrian per ENI untuk tipe instans dan kuota antrian untuk tipe instans, Anda dapat memanggil operasi DescribeInstanceTypes dan memeriksa nilai MaximumQueueNumberPerEni dan TotalEniQueueQuantity.

  • Jika NetworkInterface.N.InstanceType diatur ke Primary, Anda tidak dapat menentukan NetworkInterfaceQueueNumber tetapi dapat menentukan NetworkInterface.N.QueueNumber.

HostNames

List

Tidak

Tidak

Nama host yang ingin Anda gunakan untuk beberapa instans.

Tidak ada.

ImageOptions

Map

Tidak

Tidak

Opsi gambar.

Untuk informasi lebih lanjut, lihat Properti ImageOptions.

SecurityOptions

Map

Tidak

Tidak

Opsi sistem tepercaya.

Untuk informasi lebih lanjut, lihat Properti SecurityOptions.

SchedulerOptions

Map

Tidak

Tidak

Opsi penjadwalan.

Untuk informasi lebih lanjut, lihat Properti SchedulerOptions.

Sintaksis DiskMappings

"DiskMappings": [
  {
    "Category": String,
    "DiskName": String,
    "Description": String,
    "Device": String,
    "SnapshotId": String,
    "Size": String,
    "Encrypted": String,
    "KMSKeyId": String,
    "PerformanceLevel": String,
    "AutoSnapshotPolicyId": String,
    "ProvisionedIops": Integer,
    "BurstingEnabled": Boolean,
    "StorageClusterId": String
  }
]

Properti DiskMappings

Properti

Tipe

Diperlukan

Dapat Diedit

Deskripsi

Kendala

Ukuran

String

Ya

Tidak

Ukuran disk data.

Satuan: GB.

Kategori

String

Tidak

Tidak

Kategori dari disk data.

Nilai yang valid:

  • cloud: disk dasar

  • cloud_efficiency: disk ultra

  • cloud_ssd: SSD standar

  • cloud_essd: ESSD

  • ephemeral_ssd: SSD lokal

Nilai default untuk instance yang dioptimalkan I/O adalah cloud_efficiency.

Nilai default untuk instance yang tidak dioptimalkan I/O adalah cloud.

DiskName

String

Tidak

Tidak

Nama disk data.

Nama harus memiliki panjang 2 hingga 128 karakter. Nama harus dimulai dengan huruf dan tidak boleh dimulai dengan http:// atau https://. Nama dapat berisi huruf, angka, garis bawah (_), titik dua (:), dan tanda hubung (-).

Deskripsi

String

Tidak

Tidak

Deskripsi dari disk data.

Deskripsi harus memiliki panjang 2 hingga 256 karakter. Tidak boleh dimulai dengan http:// atau https://.

Perangkat

String

Tidak

Tidak

Target mount.

Tidak ada.

SnapshotId

String

Tidak

Tidak

ID snapshot.

Tidak ada.

Terenkripsi

String

Tidak

Tidak

Menentukan apakah disk data akan dienkripsi.

Nilai yang valid:

  • true

  • false (default)

KMSKeyId

String

Tidak

Tidak

ID dari kunci KMS yang ingin Anda gunakan untuk disk data.

Tidak ada.

AutoSnapshotPolicyId

String

Tidak

Tidak

ID dari kebijakan snapshot otomatis.

Tidak ada.

TingkatKinerja

String

Tidak

Tidak

PL dari ESSD yang ingin Anda gunakan sebagai disk data.

Nilai yang valid:

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

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

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

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

Untuk informasi lebih lanjut tentang cara memilih PL dari ESSD, lihat ESSDs.

ProvisionedIops

Bilangan Bulat

Tidak

Tidak

IOPS yang disediakan.

Tidak ada.

BurstingEnabled

Boolean

Tidak

Tidak

Menentukan apakah akan mengaktifkan mode burst.

Nilai yang valid:

  • true

  • false (bawaan)

StorageClusterId

String

Tidak

Tidak

ID dari kluster penyimpanan blok khusus.

Tidak ada.

Sintaks Tag

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

Properti Tag

Properti

Tipe

Diperlukan

Dapat Diedit

Deskripsi

Batasan

Kunci

String

Ya

Tidak

Kunci tag.

Kunci tag harus memiliki panjang 1 hingga 128 karakter, dan tidak boleh mengandung http:// atau https://. Tidak boleh dimulai dengan aliyun atau acs:.

Nilai

String

Tidak

Tidak

Nilai tag.

Nilai tag dapat memiliki panjang hingga 128 karakter, dan tidak boleh mengandung http:// atau https://. Tidak boleh dimulai dengan aliyun atau acs:.

Sintaks EniMappings

"EniMappings": [
  {
    "SecurityGroupId": String,
    "VSwitchId": String,
    "Description": String,
    "NetworkInterfaceName": String,
    "PrimaryIpAddress": String,
    "InstanceType": String,
    "Ipv6AddressCount": Integer,
    "NetworkInterfaceTrafficMode": String,
    "Ipv6Addresses": List,
    "QueueNumber": Integer,
    "SecurityGroupIds": List,
    "NetworkInterfaceId": String,
    "DeleteOnRelease": Boolean,
    "NetworkCardIndex": Integer,
    "QueuePairNumber": Integer
  }
]

Properti EniMappings

Properti

Tipe

Diperlukan

Dapat Diedit

Deskripsi

Batasan

SecurityGroupId

String

Tidak

Ya

ID grup keamanan tempat ENI berada.

Grup keamanan dan Instance ECS harus berada dalam VPC yang sama.

VSwitchId

String

Tidak

Tidak

ID vSwitch.

Tidak ada.

Description

String

Tidak

Ya

Deskripsi ENI.

Deskripsi harus memiliki panjang 2 hingga 256 karakter, dan tidak boleh dimulai dengan http:// atau https://.

NetworkInterfaceName

String

Tidak

Ya

Nama ENI.

Nama harus memiliki panjang 2 hingga 128 karakter. Nama harus dimulai dengan huruf dan tidak boleh dimulai dengan http:// atau https://. Nama dapat berisi huruf, angka, titik dua (:), garis bawah (_), dan tanda hubung (-).

PrimaryIpAddress

String

Tidak

Tidak

Alamat IP privat utama dari ENI.

Alamat IP harus merupakan alamat IP yang tidak digunakan dalam blok CIDR vSwitch.

Jika Anda membiarkan properti ini kosong, alamat IP yang tidak digunakan akan ditetapkan secara acak dari blok CIDR vSwitch.

InstanceType

String

Tidak

Tidak

Tipe ENI.

Anda dapat melampirkan hingga dua ENI. Jika Anda hanya melampirkan satu ENI, Anda dapat mengonfigurasi ENI utama atau sekunder. Jika Anda melampirkan dua ENI, Anda harus mengonfigurasi ENI utama dan sekunder.

Nilai valid:

  • Utama

  • Sekunder (default)

Ipv6AddressCount

Integer

Tidak

Tidak

Jumlah alamat IPv6 yang dihasilkan untuk ENI utama secara acak.

Nilai valid: 1 hingga 10.

Perhatikan hal-hal berikut:

  • Properti ini berlaku hanya ketika NetworkInterface.InstanceType disetel ke Utama. Jika NetworkInterface.InstanceType disetel ke Sekunder atau dibiarkan kosong, Anda tidak dapat menentukan NetworkInterface.Ipv6AddressCount.

  • Setelah Anda menentukan NetworkInterface.Ipv6AddressCount, Anda tidak dapat menentukan Ipv6AddressCount, Ipv6Address, atau NetworkInterface.Ipv6Address.

NetworkInterfaceTrafficMode

String

Tidak

Tidak

Mode komunikasi ENI.

Nilai valid:

  • Standar (default): menggunakan mode komunikasi TCP.

  • HighPerformance: menggunakan mode komunikasi remote direct memory access (RDMA) dengan fitur Elastic RDMA Interface (ERI) diaktifkan.

Catatan

Jumlah ENI dalam mode RDMA yang dapat dilampirkan ke instance tidak boleh melebihi jumlah maksimum ENI yang didukung oleh keluarga instance. Untuk informasi lebih lanjut, lihat Ikhtisar keluarga instance.

Ipv6Addresses

Daftar

Tidak

Tidak

Satu atau lebih alamat IPv6 yang ditetapkan ke ENI utama.

Anda dapat menentukan hingga 10 alamat IPv6.

Perhatikan hal-hal berikut:

  • Properti ini berlaku hanya ketika NetworkInterface.InstanceType disetel ke Utama. Jika NetworkInterface.InstanceType disetel ke Sekunder atau dibiarkan kosong, Anda tidak dapat menentukan NetworkInterface.Ipv6Addresses.

  • Jika Anda menentukan NetworkInterface.Ipv6Addresses, Anda harus menetapkan Jumlah ke 1 dan tidak dapat menentukan Ipv6AddressCount, Ipv6Address.N, atau NetworkInterface.N.Ipv6AddressCount.

QueueNumber

Integer

Tidak

Tidak

Jumlah antrian yang didukung oleh ENI.

Perhatikan hal-hal berikut:

  • Nilai valid: 1 dan 2. Jika Anda melampirkan hanya satu ENI, Anda dapat mengonfigurasi ENI utama atau sekunder. Jika Anda melampirkan dua ENI, Anda harus mengonfigurasi ENI utama dan sekunder.

  • Nilai properti ini tidak boleh melebihi jumlah maksimum antrian per ENI yang diizinkan untuk tipe instance.

  • Jumlah total antrian untuk semua ENI pada instance tidak boleh melebihi kuota antrian untuk tipe instance. Untuk menanyakan jumlah maksimum antrian per ENI untuk tipe instance dan kuota antrian untuk tipe instance, Anda dapat memanggil operasi DescribeInstanceTypes dan memeriksa nilai MaximumQueueNumberPerEni dan TotalEniQueueQuantity.

  • Jika NetworkInterface.InstanceType disetel ke Utama dan QueueNumber ditentukan, Anda tidak dapat menentukan NetworkInterfaceQueueNumber.

SecurityGroupIds

Daftar

Tidak

Tidak

ID satu atau lebih grup keamanan tempat ENI berada.

Perhatikan hal-hal berikut:

  • Jika NetworkInterface.N.InstanceType disetel ke Utama, Anda harus menentukan NetworkInterface.SecurityGroupIds atau NetworkInterface.SecurityGroupId. Dalam hal ini, NetworkInterface.SecurityGroupIds memiliki efek yang sama dengan SecurityGroupIds. Selain itu, Anda tidak dapat menentukan SecurityGroupId, SecurityGroupIds, atau NetworkInterface.SecurityGroupId.

  • Jika NetworkInterface.N.InstanceType disetel ke Sekunder atau dibiarkan kosong, NetworkInterface.SecurityGroupIds bersifat opsional. Nilai default adalah ID satu atau lebih grup keamanan tempat Instance ECS berada.

NetworkInterfaceId

String

Tidak

Tidak

ID ENI yang ingin Anda lampirkan ke instance.

Properti ini berlaku hanya untuk ENI sekunder. Setelah Anda menggunakan properti ini untuk menentukan ENI sekunder yang ada, Anda tidak dapat mengonfigurasi properti lain yang digunakan untuk membuat ENI.

DeleteOnRelease

Boolean

Tidak

Tidak

Menentukan apakah akan mempertahankan ENI saat instance terkait dilepaskan.

Nilai valid:

  • true

  • false

NetworkCardIndex

Integer

Tidak

Tidak

Indeks kartu jaringan yang ingin Anda tentukan untuk ENI.

  • Anda dapat menentukan indeks kartu jaringan hanya untuk instance dari tipe instance tertentu.

  • Jika NetworkInterface.N.InstanceType disetel ke Utama, Anda harus menetapkan NetworkCardIndex ke 0 untuk tipe instance yang mendukung kartu jaringan.

  • Jika NetworkInterface.N.InstanceType disetel ke Sekunder atau dibiarkan kosong, Anda dapat menentukan NetworkCardIndex berdasarkan tipe instance untuk tipe instance yang mendukung kartu jaringan. Untuk informasi lebih lanjut, lihat Ikhtisar keluarga instance.

QueuePairNumber

Integer

Tidak

Tidak

Jumlah antrian yang didukung oleh ENI dalam mode RDMA.

QueuePairNumber adalah tipe data Long. Presisi nilai properti mungkin hilang selama proses serialisasi atau deserialisasi. Anda harus memastikan bahwa nilai tersebut tidak melebihi 9007199254740991.

Sintaksis PrivatePoolOptions

"PrivatePoolOptions": [
  {
    "Id": String,
    "MatchCriteria": String
  }
]

Properti PrivatePoolOptions

Properti

Tipe

Diperlukan

Dapat Diedit

Deskripsi

Kendala

Id

String

Tidak

Tidak

ID kolam pribadi. ID kolam pribadi sama dengan ID jaminan elastisitas atau reservasi kapasitas tempat kolam pribadi dibuat.

Tidak ada.

MatchCriteria

String

Tidak

Tidak

Jenis kolam pribadi yang ingin digunakan untuk memulai instans. Kolam pribadi dibuat setelah jaminan elastisitas atau reservasi kapasitas diterapkan.

Nilai valid:

  • Open: kolam pribadi terbuka. Sistem menggunakan kapasitas dalam kolam pribadi terbuka yang cocok. Jika tidak ada kolam pribadi terbuka yang cocok, sistem menggunakan kapasitas dalam kolam publik. Saat Anda mengatur properti ini ke Open, Anda tidak perlu menentukan PrivatePoolOptions.Id.

  • Target: kolam pribadi tertentu. Sistem menggunakan kapasitas dalam kolam pribadi yang ditentukan. Jika tidak ada kapasitas yang tersedia dalam kolam pribadi yang ditentukan, instans gagal dimulai. Saat Anda mengatur properti ini ke Target, Anda harus menentukan PrivatePoolOptions.Id.

  • None (default): tanpa kolam pribadi. Sistem tidak menggunakan kapasitas dalam kolam pribadi.

PrivatePoolOptions.MatchCriteria harus diatur ke None atau dibiarkan kosong dalam skenario berikut:

  • Membuat instans preemptible.

  • Membuat instans ECS dalam jaringan klasik.

  • Membuat instans ECS pada host khusus.

Sintaksis NetworkOptions

"NetworkOptions": {
  "EnableJumboFrame": Boolean
}

Properti NetworkOptions

Properti

Tipe

Diperlukan

Dapat Diedit

Deskripsi

Kendala

EnableJumboFrame

Boolean

Tidak

Tidak

Menentukan apakah akan mengaktifkan fitur jumbo frame untuk instans.

Nilai valid:

  • false: tidak mengaktifkan fitur jumbo frame untuk instans. Nilai MTU maksimum semua ENI pada instans diatur ke 1500.

  • true: mengaktifkan fitur jumbo frame untuk instans. Nilai MTU maksimum semua ENI pada instans diatur ke 8500.

Nilai default: true.

Catatan

Fitur jumbo frame hanya didukung oleh tipe instans tertentu yang generasinya lebih baru dari generasi kedelapan. Untuk informasi lebih lanjut, lihat Jumbo Frames.

Sintaksis CpuOptions

"CpuOptions": {
  "ThreadsPerCore": Integer,
  "Core": Integer
}

Properti CpuOptions

Properti

Tipe

Diperlukan

Dapat Diedit

Deskripsi

Kendala

ThreadsPerCore

Integer

Tidak

Tidak

Jumlah thread per core.

Jumlah vCPU dari instance ECS dihitung berdasarkan rumus berikut: Jumlah vCPU = nilai CpuOptions.Core × nilai CpuOptions.ThreadsPerCore.

Core

Integer

Tidak

Tidak

Jumlah core CPU fisik.

Anda tidak dapat menentukan nilai kustom untuk properti ini. Anda harus mengatur properti ini ke salah satu nilai defaultnya.

Untuk informasi lebih lanjut tentang nilai default, lihat Tentukan dan Lihat Opsi CPU.

Sintaksis ImageOptions

"ImageOptions": {
  "LoginAsNonRoot": Boolean
}

Properti ImageOptions

Properti

Tipe

Diperlukan

Dapat Diedit

Deskripsi

Kendala

LoginAsNonRoot

Boolean

Tidak

Tidak

Menentukan apakah instans yang menggunakan gambar mendukung log masuk pengguna ecs-user.

Nilai valid:

  • true

  • false

Sintaksis SecurityOptions

"SecurityOptions": {
  "TrustedSystemMode": String
}

Properti SecurityOptions

Properti

Tipe

Diperlukan

Dapat Diedit

Deskripsi

Kendala

TrustedSystemMode

String

Tidak

Tidak

Mode sistem tepercaya.

Atur nilai ke vTPM. Mode sistem tepercaya mendukung keluarga instans g7, c7, dan r7 serta keluarga instans dengan peningkatan keamanan g7t, c7t, dan r7t. Anda harus menentukan properti ini saat membuat instans ECS dari keluarga instans tersebut. Perhatikan informasi berikut: Jika Anda menggunakan Sistem Tepercaya Alibaba Cloud, Anda harus mengatur properti ini ke vTPM. Kemudian, Sistem Tepercaya Alibaba Cloud melakukan verifikasi kepercayaan saat instans dimulai. Jika Anda tidak menggunakan Sistem Tepercaya Alibaba Cloud, Anda dapat membiarkan properti ini kosong. Dalam hal ini, Anda harus menyadari bahwa jika Anda mengatur SecurityOptions.ConfidentialComputingMode ke Enclave untuk menggunakan lingkungan komputasi rahasia berbasis enklaf untuk instans ECS, Sistem Tepercaya Alibaba Cloud diaktifkan untuk instans tersebut. Saat Anda memanggil operasi API untuk membuat instans ECS yang menggunakan Sistem Tepercaya Alibaba Cloud, Anda hanya dapat memanggil operasi RunInstances untuk menentukan SecurityOptions.TrustedSystemMode. Operasi CreateInstance tidak mendukung SecurityOptions.TrustedSystemMode.

Catatan

Jika Anda mengonfigurasi instans sebagai instans tepercaya saat membuat instans, Anda hanya dapat menggunakan gambar yang mendukung Sistem Tepercaya Alibaba Cloud untuk mengganti disk sistem instans.

Untuk informasi lebih lanjut tentang sistem tepercaya, lihat Ikhtisar.

Sintaksis SchedulerOptions

"SchedulerOptions": {
  "ManagedPrivateSpaceId": String,
  "DedicatedHostClusterId": String
}

Properti SchedulerOptions

Properti

Tipe

Diperlukan

Dapat Diedit

Deskripsi

Kendala

DedicatedHostClusterId

String

Tidak

Tidak

ID kluster host khusus tempat Anda ingin membuat instans ECS. Sistem secara otomatis memilih host khusus dari kluster yang ditentukan untuk membuat instans.

Catatan

Properti ini hanya berlaku ketika Tenancy diatur ke host.

Saat Anda menentukan DedicatedHostId dan SchedulerOptions.DedicatedHostClusterId, perhatikan hal-hal berikut:

  • Jika host khusus yang ditentukan termasuk dalam kluster host khusus yang ditentukan, instans akan diprioritaskan diterapkan pada host khusus yang ditentukan.

  • Jika host khusus yang ditentukan tidak termasuk dalam kluster host khusus yang ditentukan, instans gagal dibuat.

Anda dapat memanggil operasi DescribeDedicatedHostClusters untuk menanyakan ID kluster host khusus.

ManagedPrivateSpaceId

String

Tidak

Tidak

ID kolam pribadi yang dikelola.

Tidak ada.

Nilai Pengembalian

Fn::GetAtt

  • InstanceIds: ID instance ECS. ID instans adalah GUID yang dihasilkan oleh sistem untuk instans tersebut.

  • PrivateIps: alamat IP privat instance ECS dalam VPC. Properti ini berlaku saat NetworkType diatur ke vpc. Nilainya adalah array JSON yang dapat berisi hingga 100 alamat IP yang dipisahkan oleh koma (,). Contoh: ["172.16.XX.XX", "172.16.XX.XX", … "172.16.XX.XX"].

  • InnerIps: alamat IP privat instance ECS dalam jaringan klasik. Properti ini berlaku saat NetworkType diatur ke classic. Nilainya adalah array JSON yang dapat berisi hingga 100 alamat IP yang dipisahkan oleh koma (,). Contoh: ["10.1.XX.XX", "10.1.XX.XX", …, "10.1.XX.XX"].

  • PublicIps: alamat IP publik instance ECS dalam jaringan klasik. Properti ini berlaku saat NetworkType diatur ke classic. Nilainya adalah array JSON yang dapat berisi hingga 100 alamat IP yang dipisahkan oleh koma (,). Contoh: ["42.1.XX.XX", "42.1.XX.XX", … "42.1.XX.XX"].

  • HostNames: nama host instance ECS.

  • OrderId: ID pesanan instance ECS.

  • ZoneIds: ID zona.

  • RelatedOrderIds: daftar ID pesanan terkait dengan instans ECS yang dibuat.

  • Ipv6AddressIds: ID alamat IPv6 instance ECS.

    Catatan

    ID alamat IPv6 dikembalikan dalam daftar bersarang dua tingkat. Jika instance ECS tidak memiliki alamat IPv6, elemen pada posisi relevan dalam daftar kosong. Jika semua instance ECS tidak memiliki alamat IP, null dikembalikan.

  • Ipv6Addresses: alamat IPv6 instance ECS.

    Catatan

    Alamat IPv6 dikembalikan dalam daftar bersarang dua tingkat. Jika instance ECS tidak memiliki alamat IPv6, elemen pada posisi relevan dalam daftar kosong. Jika semua instance ECS tidak memiliki alamat IP, null dikembalikan.

Contoh

Kode sampel berikut menunjukkan cara membuat instans ECS OpsEcsInstance dan ProdEcsInstance serta mengonfigurasi log masuk tanpa kata sandi untuk instans OpsEcsInstance ke instans ProdEcsInstance.

Jika Anda ingin mengirim sinyal hasil eksekusi skrip user-data dari instans ECS, Anda dapat mengonfigurasi ALIYUN::ROS::WaitCondition. Untuk informasi lebih lanjut, lihat ALIYUN::ROS::WaitCondition.

Format YAML

ROSTemplateFormatVersion: '2015-09-01'
Description: Membuat instans ECS VPC
Parameters:
  VpcId:
    AssociationProperty: ALIYUN::ECS::VPC::VPCId
    Type: String
    Description:
      en: Silakan cari ID yang dimulai dengan (vpc-xxx) dari konsol-Virtual Private Cloud
         
    Label:
      en: ID VPC
         
  VSwitchZoneId:
    AssociationProperty: ALIYUN::ECS::Instance:ZoneId
    Type: String
    Description:
         
      en: Zona Ketersediaan VSwitch
    Label:
         
      en: Zona Ketersediaan VSwitch
  VSwitchId:
    AssociationProperty: ALIYUN::ECS::VSwitch::VSwitchId
    AssociationPropertyMetadata:
      VpcId: ${VpcId}
      ZoneId: ${VSwitchZoneId}
    Type: String
    Description:
      en: ID instans saklar jaringan bisnis yang ada, konsol-Virtual Private Cloud-Switches di bawah pencarian
         
    Label:
      en: ID VSwitch
         
  SecurityGroupId:
    Type: String
    AssociationProperty: ALIYUN::ECS::SecurityGroup::SecurityGroupId
    AssociationPropertyMetadata:
      VpcId: ${VpcId}
    Description:
      en: Silakan cari ID grup keamanan bisnis yang dimulai dengan(sg-xxx)dari konsol-ECS-Jaringan & Keamanan
         
    Label:
      en: ID Grup Keamanan Bisnis
         
  InstanceType:
    Type: String
    Description:
         
      en: Isi spesifikasi yang dapat digunakan di bawah zona ketersediaan VSwitch.
    Label:
         
      en: Tipe Instans
    AssociationProperty: ALIYUN::ECS::Instance::InstanceType
    AssociationPropertyMetadata:
      ZoneId: ${VSwitchZoneId}
  SystemDiskCategory:
    Type: String
    Label:
      en: Jenis Disk Sistem
         
    Description:
      en: Jenis Disk Sistem
         
    AssociationProperty: ALIYUN::ECS::Disk::SystemDiskCategory
    AssociationPropertyMetadata:
      ZoneId: ${VSwitchZoneId}
      InstanceType: ${InstanceType}
Resources:
  OpsEcsInstance:
    Type: ALIYUN::ECS::InstanceGroup
    Properties:
      MaxAmount: 1
      HostName: OpsEcsInstance
      UserData:
        Fn::Sub:
          - |
            #!/bin/bash
            RootPassword=${RootPassword}
            ProdIP=${ProdIP}
            SSHConfig() {
            echo '[ !  -f /root/.ssh/id_rsa.pub ] && ssh-keygen -t rsa -P "" -f ~/.ssh/id_rsa &>/dev/null' >> /tmp/auto_ssh.sh
            echo 'while read line;do' >> /tmp/auto_ssh.sh
            echo '        ip=`echo $line | cut -d " " -f1`' >> /tmp/auto_ssh.sh
            echo '        user_name=`echo $line | cut -d " " -f2`' >> /tmp/auto_ssh.sh
            echo '        pass_word=`echo $line | cut -d " " -f3`' >> /tmp/auto_ssh.sh
            echo 'expect <<EOF' >> /tmp/auto_ssh.sh
            echo '        spawn ssh-copy-id -i /root/.ssh/id_rsa.pub $user_name@$ip' >> /tmp/auto_ssh.sh
            echo '        expect {' >> /tmp/auto_ssh.sh
            echo '                  "yes/no" { send "yes\n";exp_continue}' >> /tmp/auto_ssh.sh
            echo '                  "password" { send "$pass_word\n"}' >> /tmp/auto_ssh.sh
            echo '        }' >> /tmp/auto_ssh.sh
            echo '        expect eof' >> /tmp/auto_ssh.sh
            echo 'EOF' >> /tmp/auto_ssh.sh
            echo 'done < /tmp/host_ip.txt' >> /tmp/auto_ssh.sh
            }
            SetHostsConfig() {
            echo "`ifconfig eth0 | awk '/inet /{print $2}'` root ${RootPassword}" >> /tmp/host_ip.txt
            echo "${ProdIP} root ${RootPassword}" >> /tmp/host_ip.txt
            sh /tmp/auto_ssh.sh
            }
            main() {
            yum install -y expect
            SSHConfig
            SetHostsConfig
            rm -rf /tmp/host_ip.txt
            }
            main
          - ProdIP:
              Fn::Select:
                - '0'
                - Fn::GetAtt:
                    - ProdEcsInstance
                    - PrivateIps
            RootPassword: Admin@123!
      VpcId:
        Ref: VpcId
      SecurityGroupId:
        Ref: SecurityGroupId
      VSwitchId:
        Ref: VSwitchId
      ImageId: centos_7
      AllocatePublicIP: false
      InstanceType:
        Ref: InstanceType
      SystemDiskSize: 40
      SystemDiskCategory:
        Ref: SystemDiskCategory
      Password: Admin@123!
  ProdEcsInstance:
    Type: ALIYUN::ECS::InstanceGroup
    Properties:
      MaxAmount: 1
      HostName: ProdEcsInstance
      SystemDiskCategory:
        Ref: SystemDiskCategory
      VpcId:
        Ref: VpcId
      SecurityGroupId:
        Ref: SecurityGroupId
      SystemDiskSize: 40
      ImageId: centos_7
      VSwitchId:
        Ref: VSwitchId
      Password: Admin@123!
      InstanceType:
        Ref: InstanceType
      AllocatePublicIP: false
Outputs: {}                  

Format JSON

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Description": "Membuat instans ECS VPC",
  "Parameters": {
    "VpcId": {
      "AssociationProperty": "ALIYUN::ECS::VPC::VPCId",
      "Type": "String",
      "Description": {
        "en": "Silakan cari ID yang dimulai dengan (vpc-xxx) dari konsol-Virtual Private Cloud",
         
      },
      "Label": {
        "en": "ID VPC",
         
      }
    },
    "VSwitchZoneId": {
      "AssociationProperty": "ALIYUN::ECS::Instance:ZoneId",
      "Type": "String",
      "Description": {
         
        "en": "Zona Ketersediaan VSwitch"
      },
      "Label": {
         
        "en": "Zona Ketersediaan VSwitch"
      }
    },
    "VSwitchId": {
      "AssociationProperty": "ALIYUN::ECS::VSwitch::VSwitchId",
      "AssociationPropertyMetadata": {
        "VpcId": "${VpcId}",
        "ZoneId": "${VSwitchZoneId}"
      },
      "Type": "String",
      "Description": {
        "en": "ID instans saklar jaringan bisnis yang ada, konsol-Virtual Private Cloud-VSwitches di bawah pencarian",
         
      },
      "Label": {
        "en": "ID VSwitch",
         
      }
    },
    "SecurityGroupId": {
      "Type": "String",
      "AssociationProperty": "ALIYUN::ECS::SecurityGroup::SecurityGroupId",
      "AssociationPropertyMetadata": {
        "VpcId": "${VpcId}"
      },
      "Description": {
        "en": "Silakan cari ID grup keamanan bisnis yang dimulai dengan(sg-xxx)dari konsol-ECS-Jaringan & Keamanan",
         
      },
      "Label": {
        "en": "ID Grup Keamanan Bisnis",
         
      }
    },
    "InstanceType": {
      "Type": "String",
      "Description": {
         
        "en": "Isi spesifikasi yang dapat digunakan di bawah zona ketersediaan VSwitch."
      },
      "Label": {
         
        "en": "Tipe Instans"
      },
      "AssociationProperty": "ALIYUN::ECS::Instance::InstanceType",
      "AssociationPropertyMetadata": {
        "ZoneId": "${VSwitchZoneId}"
      }
    },
    "SystemDiskCategory": {
      "Type": "String",
      "Label": {
        "en": "Jenis Disk Sistem",
         
      },
      "Description": {
        "en": "Jenis Disk Sistem",
         
      },
      "AssociationProperty": "ALIYUN::ECS::Disk::SystemDiskCategory",
      "AssociationPropertyMetadata": {
        "ZoneId": "${VSwitchZoneId}",
        "InstanceType": "${InstanceType}"
      }
    }
  },
  "Resources": {
    "OpsEcsInstance": {
      "Type": "ALIYUN::ECS::InstanceGroup",
      "Properties": {
        "MaxAmount": 1,
        "HostName": "OpsEcsInstance",
        "UserData": {
          "Fn::Sub": [
            "#!/bin/bash\nRootPassword=${RootPassword}\nProdIP=${ProdIP}\nSSHConfig() {\necho '[ !  -f /root/.ssh/id_rsa.pub ] && ssh-keygen -t rsa -P \"\" -f ~/.ssh/id_rsa &>/dev/null' >> /tmp/auto_ssh.sh\necho 'while read line;do' >> /tmp/auto_ssh.sh\necho '        ip=`echo $line | cut -d \" \" -f1`' >> /tmp/auto_ssh.sh\necho '        user_name=`echo $line | cut -d \" \" -f2`' >> /tmp/auto_ssh.sh\necho '        pass_word=`echo $line | cut -d \" \" -f3`' >> /tmp/auto_ssh.sh\necho 'expect <<EOF' >> /tmp/auto_ssh.sh\necho '        spawn ssh-copy-id -i /root/.ssh/id_rsa.pub $user_name@$ip' >> /tmp/auto_ssh.sh\necho '        expect {' >> /tmp/auto_ssh.sh\necho '                  \"yes/no\" { send \"yes\\n\";exp_continue}' >> /tmp/auto_ssh.sh\necho '                  \"password\" { send \"$pass_word\\n\"}' >> /tmp/auto_ssh.sh\necho '        }' >> /tmp/auto_ssh.sh\necho '        expect eof' >> /tmp/auto_ssh.sh\necho 'EOF' >> /tmp/auto_ssh.sh\necho 'done < /tmp/host_ip.txt' >> /tmp/auto_ssh.sh\n}\nSetHostsConfig() {\necho \"`ifconfig eth0 | awk '/inet /{print $2}'` root ${RootPassword}\" >> /tmp/host_ip.txt\necho \"${ProdIP} root ${RootPassword}\" >> /tmp/host_ip.txt\nsh /tmp/auto_ssh.sh\n}\nmain() {\nyum install -y expect\nSSHConfig\nSetHostsConfig\nrm -rf /tmp/host_ip.txt\n}\nmain\n",
            {
              "ProdIP": {
                "Fn::Select": [
                  "0",
                  {
                    "Fn::GetAtt": [
                      "ProdEcsInstance",
                      "PrivateIps"
                    ]
                  }
                ]
              },
              "RootPassword": "Admin@123!"
            }
          ]
        },
        "VpcId": {
          "Ref": "VpcId"
        },
        "SecurityGroupId": {
          "Ref": "SecurityGroupId"
        },
        "VSwitchId": {
          "Ref": "VSwitchId"
        },
        "ImageId": "centos_7",
        "AllocatePublicIP": false,
        "InstanceType": {
          "Ref": "InstanceType"
        },
        "SystemDiskSize": 40,
        "SystemDiskCategory": {
          "Ref": "SystemDiskCategory"
        },
        "Password": "Admin@123!"
      }
    },
    "ProdEcsInstance": {
      "Type": "ALIYUN::ECS::InstanceGroup",
      "Properties": {
        "MaxAmount": 1,
        "HostName": "ProdEcsInstance",
        "SystemDiskCategory": {
          "Ref": "SystemDiskCategory"
        },
        "VpcId": {
          "Ref": "VpcId"
        },
        "SecurityGroupId": {
          "Ref": "SecurityGroupId"
        },
        "SystemDiskSize": 40,
        "ImageId": "centos_7",
        "VSwitchId": {
          "Ref": "VSwitchId"
        },
        "Password": "Admin@123!",
        "InstanceType": {
          "Ref": "InstanceType"
        },
        "AllocatePublicIP": false
      }
    }
  },
  "Outputs": {
  }
}                    

Ikhtisar UpdatePolicy

Setelah menggunakan ALIYUN::ECS::InstanceGroup untuk membuat kumpulan instans ECS, Anda dapat menggunakan properti UpdatePolicy untuk memperbarui konfigurasi instans ECS secara batch. Bagian berikut menjelaskan properti dan sintaksis UpdatePolicy.

Sintaksis UpdatePolicy

"UpdatePolicy": {
  "RollingUpdateForOrigInstances": Map
}

Properti UpdatePolicy

Properti

Tipe

Diperlukan

Dapat Diedit

Deskripsi

Kendala

RollingUpdateForOrigInstances

Map

Tidak

Ya

Kebijakan pembaruan untuk instans ECS yang ada.

Kebijakan ini tidak berlaku untuk instans ECS baru yang ditambahkan.

Untuk informasi lebih lanjut, lihat Properti RollingUpdateForOrigInstances.

Sintaksis RollingUpdateForOrigInstances

"RollingUpdateForOrigInstances": {
  "MaxBatchSize": Integer,
  "PauseTime": Integer
}

Properti RollingUpdateForOrigInstances

Properti

Tipe

Diperlukan

Dapat Diedit

Deskripsi

Kendala

MaxBatchSize

Integer

Ya

Ya

Jumlah instans ECS yang ingin Anda perbarui dalam setiap batch.

Nilai valid: 1 hingga 1000.

PauseTime

Integer

Tidak

Ya

Interval antara dua pembaruan batch. Nilai default: 0. Unit: detik.

Nilai valid: 0 hingga 3600.

Template sebelum dan sesudah pembaruan

Anda dapat menggunakan template berikut untuk membuat lima instans ECS dengan konfigurasi yang sama:

{
    "ROSTemplateFormatVersion": "2015-09-01",
    "Resources": {
        "Instance": {
            "Type": "ALIYUN::ECS::InstanceGroup",
            "Properties": {
                "MaxAmount": 5,
                "InstanceType": "xxxx",
                "ImageId": "centos",
                "VpcId": "vpc-2xxxx",
                "VSwitchId": "vsw-xxxx",
                "SecurityGroupId": "sg-xxxxx",
                "Password": "Ros1gregrge2345",
                "InstanceChargeType": "PostPaid",
                "NetworkType": "vpc",
                "SystemDiskCategory": "xxx",
                "SystemDiskSize": 100,
                "InternetMaxBandwidthOut": 5,
                "AllocatePublicIP": true
            }
        }
    }
}

Setelah tumpukan yang berisi instans ECS dibuat, Anda dapat menambahkan properti UpdatePolicy ke template untuk memperbarui konfigurasi instans ECS:

{
    "ROSTemplateFormatVersion": "2015-09-01",
    "Resources": {
        "Instance": {
            "Type": "ALIYUN::ECS::InstanceGroup",
            "UpdatePolicy": {
                "RollingUpdateForOrigInstances": {
                    "MaxBatchSize": 2,
                    "PauseTime": 0
                }
            },
            "Properties": {
                "MaxAmount": 10,
                "InstanceType": "xxxx",
                "ImageId": "centos",
                "VpcId": "vpc-2xxxx",
                "VSwitchId": "vsw-xxxx",
                "SecurityGroupId": "sg-xxxxx",
                "Password": "Ros1gregrge2345",
                "InstanceChargeType": "PostPaid",
                "NetworkType": "vpc",
                "SystemDiskCategory": "xxx",
                "SystemDiskSize": 100,
                "InternetMaxBandwidthOut": 5,
                "AllocatePublicIP": true
            }
        }
    }
}

Dalam kode sampel di atas, MaxBatchSize diatur ke 2. Nilai MaxAmount diperbarui dari 5 menjadi 10. Selama proses pembaruan tumpukan, konfigurasi lima instans ECS asli diperbarui dalam tiga batch, masing-masing secara terpisah berisi dua, dua, dan satu instans. Lima instans ECS baru dibuat sekaligus.