All Products
Search
Document Center

Resource Orchestration Service:ALIYUN::ECS::InstanceGroupClone

Last Updated:Feb 27, 2026

Gunakan ALIYUN::ECS::InstanceGroupClone untuk mengkloning sekelompok instans ECS.

Sintaks

 {
  "Type": "ALIYUN::ECS::InstanceGroupClone",
  "Properties": {
    "BackendServerWeight": Integer,
    "SystemDiskAutoSnapshotPolicyId": String,
    "DiskMappings": List,
    "Period": Number,
    "LaunchTemplateName": String,
    "RamRoleName": String,
    "ResourceGroupId": String,
    "KeyPairName": String,
    "SystemDiskDiskName": String,
    "PeriodUnit": String,
    "Description": String,
    "Tags": List,
    "AutoRenewPeriod": Number,
    "ImageId": String,
    "AutoRenew": String,
    "SpotStrategy": String,
    "SourceInstanceId": String,
    "EniMappings": List,
    "Password": String,
    "PasswordInherit": Boolean,
    "MaxAmount": Integer,
    "AutoReleaseTime": String,
    "SystemDiskCategory": String,
    "LoadBalancerIdToAttach": String,
    "LaunchTemplateId": String,
    "LaunchTemplateVersion": String,
    "ZoneId": String,
    "InternetMaxBandwidthOut": Integer,
    "InstanceName": String,
    "DeletionProtection": Boolean,
    "DeploymentSetId": String,
    "Ipv6AddressCount": Integer,
    "SecurityGroupId": String,
    "SecurityGroupIds": List,
    "SpotPriceLimit": String,
    "HpcClusterId": String,
    "SystemDiskDescription": String,
    "Ipv6Addresses": List,
    "SystemDiskProvisionedIops": Integer,
    "SystemDiskBurstingEnabled": Boolean,
    "SystemDiskKMSKeyId": String,
    "SystemDiskStorageClusterId": String,
    "InternetMaxBandwidthIn": Integer,
    "UpdatePolicy": String,
    "SystemDiskEncryptAlgorithm": String,
    "SystemDiskEncrypted": String,
    "SecurityOptions": Map,
    "ImageOptions": Map,
    "NetworkOptions": Map,
    "HostNames": List,
    "NetworkInterfaceQueueNumber": Integer,
    "UniqueSuffix": Boolean,
    "CpuOptions": Map
  }
}

Properti

Nama properti

Tipe

Wajib

Izinkan pembaruan

Deskripsi

Batasan

MaxAmount

Integer

Ya

Ya

Jumlah instans ECS yang akan dibuat sekaligus.

Nilai valid: 1 hingga 100.

SourceInstanceId

String

Ya

Tidak

ID instans ECS yang akan dikloning.

Tipe instans, image, metode penagihan bandwidth, batas bandwidth, jenis jaringan, dan konfigurasi lainnya akan dikloning. Jika instans ECS sumber ditambahkan ke beberapa security group, instans baru akan ditambahkan ke security group pertama dari instans sumber.

AutoReleaseTime

String

Tidak

Tidak

Waktu ketika instans ECS baru secara otomatis dirilis.

Waktu harus dalam format ISO 8601. Contoh: yyyy-MM-ddTHH:mm:ssZ. Waktu rilis tidak boleh lebih dari tiga tahun di masa depan.

AutoRenew

String

Tidak

Ya

Menunjukkan apakah perpanjangan otomatis diaktifkan.

Nilai valid:

  • True: mengaktifkan perpanjangan otomatis.

  • False (default): menonaktifkan perpanjangan otomatis.

Parameter ini wajib ditentukan ketika InstanceChargeType diatur ke PrePaid.

AutoRenewPeriod

Number

Tidak

Ya

Periode perpanjangan otomatis.

Parameter ini wajib ditentukan ketika AutoRenew diatur ke true.

Nilai valid:

  • 1 (default)

  • 2

  • 3

  • 6

  • 12

BackendServerWeight

Integer

Tidak

Tidak

Bobot instans ECS baru dalam instans SLB.

Nilai valid: 0 hingga 100.

Nilai default: 100.

CpuOptions

Map

Tidak

Tidak

Properti CPU.

Untuk informasi selengkapnya, lihat properti CpuOptions.

DeletionProtection

Boolean

Tidak

Tidak

Atribut perlindungan rilis untuk instans baru. Menentukan apakah instans dapat dirilis melalui konsol atau dengan memanggil operasi API DeleteInstance.

Nilai valid:

  • True menunjukkan dukungan.

  • false: Tidak didukung.

DeploymentSetId

String

Tidak

Ya

ID set penyebaran.

Tidak ada

Description

String

Tidak

Ya

Deskripsi.

Panjang deskripsi maksimal 256 karakter.

DiskMappings

List

Tidak

Ya

Disk yang akan disambungkan.

Maksimal mendukung 16 disk.

Untuk informasi selengkapnya, lihat properti DiskMappings.

EniMappings

List

Tidak

Ya

ENI yang akan disambungkan ke instans.

Maksimal satu ENI dapat disambungkan ke instans.

Untuk informasi selengkapnya, lihat properti EniMappings.

HostNames

List

Tidak

Tidak

Ketika membuat beberapa instans, tentukan hostname berbeda untuk setiap instans.

Tidak ada

HpcClusterId

String

Tidak

Ya

ID kluster E-HPC tempat instans baru berada.

Tidak ada

ImageId

String

Tidak

Ya

ID image yang digunakan untuk menjalankan instans ECS. Ini bisa berupa public image, custom image, atau gambar Marketplace Alibaba Cloud.

Anda dapat menggunakan pencocokan kabur untuk menentukan ID public image tanpa menyebutkan ID lengkap. Contoh:

  • Jika Anda menentukan `ubuntu`, maka `ubuntu16_0402_64_20G_alibase_20170818.vhd` akan dicocokkan.

  • Jika Anda menentukan `ubuntu_14`, maka `ubuntu_14_0405_64_20G_alibase_20170824.vhd` akan dicocokkan.

  • Jika Anda menentukan `ubuntu*14*32`, maka `ubuntu_14_0405_32_40G_alibase_20170711.vhd` akan dicocokkan.

  • Jika Anda menentukan `ubuntu_16_0402_32`, maka `ubuntu_16_0402_32_40G_alibase_20170711.vhd` akan dicocokkan.

ImageOptions

Map

Tidak

Tidak

Properti image.

Untuk informasi selengkapnya, lihat properti ImageOptions.

InstanceName

String

Tidak

Ya

Nama instans baru.

Nama dapat memiliki panjang hingga 128 karakter. Nama dapat berisi huruf, karakter Tionghoa, angka, garis bawah (_), titik (.), dan tanda hubung (-).

InternetMaxBandwidthIn

Integer

Tidak

Tidak

Bandwidth outbound Internet maksimum.

Unit: Mbit/s.

Nilai valid: 0 hingga 200.

Nilai default: 200.

InternetMaxBandwidthOut

Integer

Tidak

Tidak

Bandwidth publik keluar maksimum.

Unit: Mbit/s.

Nilai valid:

  • 0 hingga 200 untuk pay-by-bandwidth.

  • 1 hingga 200 untuk pay-by-data-transfer.

Ipv6AddressCount

Integer

Tidak

Ya

Jumlah alamat IPv6 yang dihasilkan secara acak untuk ditetapkan ke ENI.

Anda tidak dapat menentukan Ipv6Addresses dan Ipv6AddressCount secara bersamaan.

Ipv6Addresses

List

Tidak

Ya

Satu atau beberapa alamat IPv6 untuk ditetapkan ke ENI.

Daftar ini dapat berisi maksimal satu alamat. Perubahan pada properti ini tidak memengaruhi instans yang sudah ada. Anda tidak dapat menentukan Ipv6Addresses dan Ipv6AddressCount secara bersamaan.

KeyPairName

String

Tidak

Ya

Nama pasangan kunci yang akan disambungkan ke instans ECS baru.

Parameter ini diabaikan untuk instans ECS Windows. Jika Anda menentukan KeyPairName, nilai Password tetap diatur untuk instans, tetapi logon berbasis password dinonaktifkan untuk sistem Linux.

LaunchTemplateId

String

Tidak

Ya

ID template peluncuran.

Tidak ada

LaunchTemplateName

String

Tidak

Ya

Nama template peluncuran.

Tidak ada

LaunchTemplateVersion

String

Tidak

Ya

Versi template peluncuran.

Jika Anda tidak menentukan versi, versi default akan digunakan.

LoadBalancerIdToAttach

String

Tidak

Tidak

ID instans SLB tempat instans ECS baru ditambahkan.

Tidak ada

NetworkInterfaceQueueNumber

Integer

Tidak

Tidak

Jumlah antrian untuk NIC primer.

Catatan:

  • Nilai tidak boleh melebihi jumlah maksimum antrian per NIC yang diizinkan untuk tipe instans tersebut.

  • Jumlah total antrian untuk semua NIC instans tidak boleh melebihi kuota total antrian yang diizinkan untuk tipe instans tersebut. Anda dapat menanyakan jumlah maksimum antrian per NIC (MaximumQueueNumberPerEni) dan kuota total antrian (TotalEniQueueQuantity) untuk suatu tipe instans dengan memanggil operasi API DescribeInstanceTypes.

  • Jika NetworkInterface.N.InstanceType diatur ke Primary, Anda tidak dapat mengatur NetworkInterfaceQueueNumber. Anda hanya dapat mengatur NetworkInterface.N.QueueNumber.

NetworkOptions

Map

Tidak

Tidak

Properti dan parameter terkait jaringan.

Untuk informasi selengkapnya, lihat properti NetworkOptions.

Password

String

Tidak

Ya

Kata sandi logon untuk instans ECS baru.

Kata sandi harus terdiri dari 8 hingga 30 karakter. Kata sandi harus berisi huruf, angka, dan karakter khusus. Karakter khusus yang didukung: ()`~!@#$%^&*-_+=|{}[]:;'<>,.?/.

Jika Anda menentukan parameter ini, gunakan protokol HTTPS untuk memanggil operasi API guna mencegah kebocoran kata sandi.

PasswordInherit

Boolean

Tidak

Tidak

Menunjukkan apakah akan menggunakan kata sandi preset dari image.

Nilai valid:

  • true: Gunakan kata sandi preset.

  • false: Jangan gunakan kata sandi preset.

Catatan

Saat menggunakan parameter ini, parameter Password harus kosong, dan Anda harus memastikan bahwa kata sandi telah diatur untuk image tersebut.

Period

Number

Tidak

Ya

Siklus penagihan.

Nilai valid: 1 hingga 9, 12, 24, 36, 48, dan 60.

Unit: bulan.

Parameter ini wajib ditentukan ketika InstanceChargeType diatur ke PrePaid. Parameter ini opsional ketika InstanceChargeType diatur ke PostPaid.

PeriodUnit

String

Tidak

Ya

Durasi pembelian resource.

Nilai valid:

  • Week

    Ketika PeriodUnit diatur ke Week, nilai valid untuk Period adalah 1, 2, 3, dan 4, serta nilai valid untuk AutoRenewPeriod adalah 1, 2, dan 3.

  • Month (default)

    Ketika PeriodUnit diatur ke Month, nilai valid untuk Period adalah 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36, 48, dan 60, serta nilai valid untuk AutoRenewPeriod adalah 1, 2, 3, 6, dan 12.

RamRoleName

String

Tidak

Ya

Nama instance RAM role untuk instans baru.

Anda dapat memanggil ListRoles untuk menanyakan nama instance RAM role. Untuk informasi selengkapnya, lihat Membuat role dan Mendapatkan daftar role.

ResourceGroupId

String

Tidak

Tidak

ID kelompok sumber daya tempat instans baru berada.

Tidak ada

SecurityGroupId

String

Tidak

Tidak

Security group tempat instans baru berada.

Anda tidak dapat menentukan SecurityGroupId dan SecurityGroupIds secara bersamaan.

SecurityGroupIds

List

Tidak

Tidak

Daftar security group tempat instans baru berada.

Untuk informasi selengkapnya, lihat Security group.

Anda tidak dapat menentukan SecurityGroupId dan SecurityGroupIds secara bersamaan.

SecurityOptions

Map

Tidak

Tidak

Properti sistem tepercaya.

Untuk informasi selengkapnya, lihat properti SecurityOptions.

SpotPriceLimit

String

Tidak

Tidak

Harga maksimum per jam untuk instans baru.

Nilai dapat memiliki hingga tiga tempat desimal. SpotPriceLimit berlaku ketika SpotStrategy diatur ke SpotWithPriceLimit.

SpotStrategy

String

Tidak

Ya

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

Parameter ini wajib ditentukan ketika InstanceChargeType diatur ke PostPaid.

Nilai valid:

  • NoSpot (default): Instans adalah instans pay-as-you-go biasa.

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

  • SpotAsPriceGo: Sistem secara otomatis menawar dengan harga optimal, yang tidak melebihi harga pay-as-you-go.

SystemDiskAutoSnapshotPolicyId

String

Tidak

Ya

ID kebijakan snapshot otomatis untuk disk sistem.

Tidak ada

SystemDiskBurstingEnabled

Boolean

Tidak

Ya

Menunjukkan apakah bursting diaktifkan untuk disk sistem.

Nilai valid:

  • true: Diaktifkan.

  • false (default): (dinonaktifkan)

SystemDiskCategory

String

Tidak

Ya

Jenis disk sistem.

Nilai valid:

  • cloud: disk dasar.

  • cloud_efficiency (default): disk ultra.

  • cloud_ssd: SSD standar.

  • cloud_essd: SSD Perusahaan (ESSD).

SystemDiskDescription

String

Tidak

Ya

Deskripsi disk sistem.

Tidak ada

SystemDiskDiskName

String

Tidak

Ya

Nama disk sistem.

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

SystemDiskEncryptAlgorithm

String

Tidak

Ya

Algoritma enkripsi yang digunakan untuk disk sistem.

Nilai valid:

  • AES-256.

  • SM4-128.

SystemDiskEncrypted

String

Tidak

Ya

Menunjukkan apakah disk sistem dienkripsi.

Nilai valid:

  • true: Mengenkripsi disk.

  • false: Enkripsi dinonaktifkan.

SystemDiskKMSKeyId

String

Tidak

Ya

ID kunci KMS yang digunakan untuk disk sistem.

Tidak ada

SystemDiskProvisionedIops

Integer

Tidak

Ya

IOPS yang disediakan untuk disk sistem.

Tidak ada

SystemDiskStorageClusterId

String

Tidak

Ya

ID kluster penyimpanan blok khusus untuk disk sistem.

Tidak ada

Tags

List

Tidak

Ya

Tag kustom.

Maksimal mendukung 20 tag. Format: [{"Key": "tagKey", "Value": "tagValue"},{"Key": "tagKey2", "Value": "tagValue2"}].

Untuk informasi selengkapnya, lihat properti Tags.

UniqueSuffix

Boolean

Tidak

Tidak

Ketika membuat beberapa instans, menunjukkan apakah akan secara otomatis menambahkan akhiran berurutan ke HostName dan InstanceName.

Akhiran berurutan dimulai dari 001 dan bertambah. Nilai maksimum tidak boleh melebihi 999. Nilai valid:

  • true: Tambahkan akhiran.

  • false (nilai default): Tidak menambahkan item.

Ketika HostName atau InstanceName diatur dalam format berurutan yang ditentukan, dan name_suffix tidak diatur (yaitu, format penamaan adalah name_prefix[begin_number,bits]), UniqueSuffix tidak berlaku. Nama hanya diurutkan sesuai urutan yang ditentukan.

Untuk informasi selengkapnya, lihat Menetapkan nama instans atau hostname secara berurutan.

UpdatePolicy

String

Tidak

Ya

Menentukan kebijakan pembaruan.

Nilai valid:

  • ForNewInstance (default): Kebijakan pembaruan berlaku untuk instans baru.

  • ForAllInstances: Kebijakan pembaruan berlaku untuk semua instans.

ZoneId

String

Tidak

Tidak

ID zona.

Tidak ada

Sintaks DiskMappings

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

Properti DiskMappings

Nama properti

Tipe

Wajib

Dapat diperbarui

Deskripsi

Batasan

Size

String

Ya

Tidak

Ukuran data disk.

Unit: GB.

AutoSnapshotPolicyId

String

Tidak

Tidak

ID kebijakan snapshot otomatis.

Tidak ada

BurstingEnabled

Boolean

Tidak

Tidak

Menunjukkan apakah bursting diaktifkan.

Nilai valid:

  • true: Mengaktifkan opsi ini.

  • false (default): dinonaktifkan.

Category

String

Tidak

Tidak

Jenis data disk.

Nilai valid:

  • cloud (default): disk dasar.

  • cloud_ssd: SSD standar.

  • cloud_essd: (SSD Perusahaan)

  • cloud_efficiency: disk ultra.

Description

String

Tidak

Tidak

Deskripsi data disk.

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

Device

String

Tidak

Tidak

Nama data disk dalam instans ECS.

Contoh: /dev/xvd[a-z].

DiskName

String

Tidak

Tidak

Nama data disk.

Nama dapat memiliki panjang hingga 128 karakter. Nama dapat berisi huruf, karakter Tionghoa, angka, garis bawah (_), titik (.), dan tanda hubung (-).

Encrypted

String

Tidak

Tidak

Menunjukkan apakah data disk dienkripsi.

Nilai valid:

  • true: Mengenkripsi data.

  • false (default): Tidak mengenkripsi.

KMSKeyId

String

Tidak

Tidak

ID kunci KMS untuk data disk.

Tidak ada

PerformanceLevel

String

Tidak

Tidak

Ketika membuat disk sistem menggunakan SSD Perusahaan, Anda dapat mengatur tingkat performanya.

Nilai valid:

  • PL0: Satu disk memberikan hingga 10.000 IOPS baca/tulis acak.

  • PL1 (default): Satu disk memberikan hingga 50.000 IOPS baca/tulis acak.

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

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

Untuk informasi tentang cara memilih tingkat performa ESSD, lihat ESSD.

ProvisionedIops

Integer

Tidak

Tidak

IOPS yang disediakan.

Tidak ada

SnapshotId

String

Tidak

Tidak

ID snapshot.

Tidak ada

StorageClusterId

String

Tidak

Tidak

ID kluster penyimpanan blok khusus.

Tidak ada

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,
    "QueuePairNumber": Integer,
    "NetworkInterfaceId": String,
    "DeleteOnRelease": Boolean,
    "NetworkCardIndex": Integer
  }
]

Properti EniMappings

Nama properti

Tipe

Wajib

Dapat diperbarui

Deskripsi

Batasan

DeleteOnRelease

Boolean

Tidak

Tidak

Menunjukkan apakah NIC dipertahankan saat instans dirilis

Nilai valid:

  • true: Tidak dipertahankan.

  • false: Pertahankan pengaturan yang ada.

Description

String

Tidak

Ya

Deskripsi ENI.

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

InstanceType

String

Tidak

Tidak

Jenis ENI.

Anda dapat mengatur maksimal dua NIC. Saat mengatur satu ENI, Anda dapat mengaturnya sebagai ENI primer atau sekunder. Saat mengatur dua ENI, Anda hanya dapat mengatur satu sebagai ENI primer dan yang lain sebagai ENI sekunder.

Nilai valid:

  • Primary: ENI primer.

  • Secondary (default): ENI sekunder.

Ipv6AddressCount

Integer

Tidak

Tidak

Jumlah alamat IPv6 yang dihasilkan secara acak untuk ditetapkan ke NIC primer.

Nilai valid: 1 hingga 10.

Catatan:

  • Parameter ini hanya berlaku ketika NetworkInterface.InstanceType diatur ke Primary. Jika NetworkInterface.InstanceType diatur ke Secondary atau kosong, Anda tidak dapat mengatur parameter ini.

  • Setelah Anda mengatur parameter ini, Anda tidak dapat mengatur Ipv6AddressCount, Ipv6Address, atau NetworkInterface.Ipv6Address.

Ipv6Addresses

List

Tidak

Tidak

Satu atau beberapa alamat IPv6 untuk ditetapkan ke NIC primer.

Anda dapat mengatur maksimal 10 alamat IPv6.

Catatan:

  • Parameter ini hanya berlaku ketika NetworkInterface.InstanceType diatur ke Primary. Jika NetworkInterface.InstanceType diatur ke Secondary atau kosong, Anda tidak dapat mengatur parameter ini.

  • Setelah Anda mengatur parameter ini, nilai Amount hanya dapat 1, dan Anda tidak dapat mengatur Ipv6AddressCount, Ipv6Address.N, atau NetworkInterface.N.Ipv6AddressCount.

NetworkCardIndex

Integer

Tidak

Tidak

Indeks NIC fisik yang ditentukan oleh NIC.

  • Hanya tipe instans tertentu yang mendukung penentuan indeks NIC fisik.

  • Ketika NetworkInterface.N.InstanceType diatur ke Primary, jika Anda mengatur parameter ini untuk tipe instans yang didukung, nilainya hanya dapat 0.

  • Ketika NetworkInterface.N.InstanceType diatur ke Secondary atau kosong, Anda dapat mengatur parameter ini berdasarkan tipe instans untuk tipe instans yang didukung. Untuk informasi selengkapnya, lihat Keluarga instans.

NetworkInterfaceId

String

Tidak

Tidak

ID ENI yang akan disambungkan ke instans.

Parameter ini hanya berlaku untuk ENI sekunder. Setelah Anda menentukan ENI sekunder yang sudah ada, Anda tidak dapat mengonfigurasi parameter pembuatan NIC lainnya.

NetworkInterfaceName

String

Tidak

Ya

Nama ENI.

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

NetworkInterfaceTrafficMode

String

Tidak

Tidak

Mode komunikasi NIC.

Nilai valid:

  • Standard (default): Menggunakan mode komunikasi TCP.

  • HighPerformance: Mengaktifkan Elastic RDMA Interface (ERI) dan menggunakan mode komunikasi RDMA.

Catatan

Jumlah ENI dalam mode RDMA tidak boleh melebihi batas untuk keluarga instans tersebut. Untuk informasi selengkapnya, lihat Keluarga instans.

PrimaryIpAddress

String

Tidak

Tidak

Alamat IP pribadi utama ENI.

Alamat IP yang ditentukan harus merupakan alamat yang tersedia dalam Blok CIDR vSwitch.

Jika Anda tidak menentukan alamat IP, alamat yang tersedia dari Blok CIDR vSwitch akan ditetapkan secara acak.

QueueNumber

Integer

Tidak

Tidak

Jumlah antrian untuk ENI.

Catatan:

  • Nilai valid: 1 hingga 2. Saat Anda mengatur satu ENI, Anda dapat mengaturnya sebagai ENI primer atau sekunder. Saat Anda mengatur dua ENI, Anda hanya dapat mengatur satu sebagai ENI primer dan yang lain sebagai ENI sekunder.

  • Nilai tidak boleh melebihi jumlah maksimum antrian per NIC yang diizinkan untuk tipe instans tersebut.

  • Jumlah total antrian untuk semua NIC instans tidak boleh melebihi kuota total antrian yang diizinkan untuk tipe instans tersebut. Anda dapat menanyakan jumlah maksimum antrian per NIC (MaximumQueueNumberPerEni) dan kuota total antrian (TotalEniQueueQuantity) untuk suatu tipe instans dengan memanggil operasi API DescribeInstanceTypes.

  • Jika NetworkInterface.InstanceType diatur ke Primary dan Anda mengatur parameter ini, Anda tidak dapat mengatur parameter NetworkInterfaceQueueNumber.

QueuePairNumber

Integer

Tidak

Tidak

Jumlah antrian untuk NIC RDMA.

Bidang ini bertipe Long. Presisi mungkin hilang selama serialisasi atau deserialisasi. Pastikan nilai tidak melebihi 9007199254740991.

SecurityGroupId

String

Tidak

Ya

ID security group.

Security group harus berada dalam VPC yang sama.

SecurityGroupIds

List

Tidak

Tidak

Satu atau beberapa ID security group tempat ENI berada.

Catatan:

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

  • Jika NetworkInterface.N.InstanceType diatur ke Secondary atau kosong, parameter ini opsional. Nilai default adalah security group instans ECS.

VSwitchId

String

Tidak

Tidak

ID vSwitch.

Tidak ada

Sintaks SecurityOptions

"SecurityOptions": {
  "TrustedSystemMode": String
}

Properti SecurityOptions

Nama properti

Type

Wajib

Dapat diperbarui

Deskripsi

Batasan

TrustedSystemMode

String

Tidak

Tidak

Mode sistem tepercaya.

Nilai valid: vTPM. Saat ini, mode sistem tepercaya didukung oleh keluarga instans g7, c7, dan r7, serta keluarga instans yang ditingkatkan keamanannya (g7t, c7t, dan r7t). Anda harus mengatur parameter ini saat membuat instans ECS dari keluarga instans tersebut. Rinciannya sebagai berikut:

Jika Anda menggunakan Sistem Tepercaya Alibaba Cloud, atur parameter ini ke vTPM. Hal ini memungkinkan instans menyelesaikan verifikasi tepercaya melalui Sistem Tepercaya Alibaba Cloud saat startup. Jika Anda tidak menggunakan Sistem Tepercaya Alibaba Cloud, Anda dapat membiarkan parameter ini kosong. Namun, perhatikan bahwa jika instans ECS yang Anda buat menggunakan mode komputasi rahasia Enclave (SecurityOptions.ConfidentialComputingMode=Enclave), sistem tepercaya juga diaktifkan untuk instans ECS tersebut. Saat Anda menggunakan OpenAPI untuk membuat instans ECS dengan sistem tepercaya, Anda hanya dapat memanggil RunInstances. CreateInstance saat ini tidak mendukung pengaturan parameter SecurityOptions.TrustedSystemMode.

Catatan

Jika Anda menentukan instans sebagai instans terpercaya saat membuatnya, Anda hanya dapat menggunakan image yang mendukung sistem tepercaya saat mengganti disk sistem.

Sintaks ImageOptions

"ImageOptions": {
  "LoginAsNonRoot": Boolean
}

Properti ImageOptions

Nama properti

Jenis

Wajib

Dapat diperbarui

Deskripsi

Batasan

LoginAsNonRoot

Boolean

Tidak

Tidak

Menunjukkan apakah instans yang menggunakan image ini mendukung logon sebagai pengguna ecs-user.

Nilai valid:

  • true: Ya.

  • false: Tidak.

Sintaks CpuOptions

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

Properti CpuOptions

Nama properti

Tipe

Wajib

Dapat diperbarui

Deskripsi

Batasan

Core

Integer

Tidak

Tidak

Jumlah core CPU.

Anda tidak dapat menyesuaikan parameter ini. Anda hanya dapat menggunakan nilai default.

Nilai default: Lihat Mengubah opsi CPU.

ThreadsPerCore

Integer

Tidak

Tidak

Jumlah thread per core CPU.

Jumlah vCPU instans ECS = Nilai CpuOptions.Core × Nilai CpuOptions.ThreadsPerCore.

Sintaks NetworkOptions

"NetworkOptions": {
  "EnableJumboFrame": Boolean
}

Properti NetworkOptions

Nama properti

Tipe

Wajib

Dapat diperbarui

Deskripsi

Batasan

EnableJumboFrame

Boolean

Tidak

Tidak

Menunjukkan apakah fitur frame jumbo diaktifkan untuk instans.

Nilai valid:

  • false: Jangan aktifkan frame jumbo. MTU semua NIC (termasuk NIC primer dan sekunder) pada instans adalah 1500.

  • true (default): Aktifkan frame jumbo. MTU semua NIC (termasuk NIC primer dan sekunder) pada instans adalah 8500.

Catatan

Hanya beberapa tipe instans generasi VIII atau yang lebih baru yang mendukung fitur frame jumbo. Untuk informasi selengkapnya, lihat Frame jumbo.

Sintaks Tags

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

Properti Tags

Nama properti

Jenis

Wajib

Dapat diperbarui

Deskripsi

Batasan

Key

String

Ya

Tidak

Kunci tag.

Kunci harus terdiri dari 1 hingga 128 karakter dan tidak boleh dimulai dengan aliyun atau acs:. Kunci tidak boleh berisi http:// atau https://.

Value

String

Tidak

Tidak

Nilai tag.

Nilai harus terdiri dari 0 hingga 128 karakter dan tidak boleh dimulai dengan aliyun atau acs:. Nilai tidak boleh berisi http:// atau https://.

Nilai kembalian

Fn::GetAtt

  • InstanceIds: ID instans baru. ID instans adalah pengidentifikasi unik global yang dihasilkan sistem untuk suatu instans.

  • PrivateIps: Daftar alamat IP pribadi instans tipe VPC. Atribut ini dikembalikan ketika parameter NetworkType diatur ke vpc. Contoh: ["172.16.XX.XX", "172.16.XX.XX", ..., "172.16.XX.XX"]. Daftar ini dapat berisi hingga 100 alamat IP.

  • InnerIps: Daftar alamat IP pribadi instans tipe Classic Network. Atribut ini dikembalikan ketika parameter NetworkType diatur ke classic. Contoh: ["10.1.XX.XX", "10.1.XX.XX", ..., "10.1.XX.XX"]. Daftar ini dapat berisi hingga 100 alamat IP.

  • PublicIps: Daftar alamat IP publik instans tipe Classic Network. Atribut ini dikembalikan ketika parameter NetworkType diatur ke classic. Contoh: ["42.1.XX.XX", "42.1.XX.XX", ..., "42.1.XX.XX"]. Daftar ini dapat berisi hingga 100 alamat IP.

  • HostNames: Daftar hostname instans baru.

  • OrderId: Daftar ID pesanan untuk instans baru.

  • ZoneIds: Daftar ID zona.

  • RelatedOrderIds: Daftar ID pesanan terkait untuk instans ECS yang dibuat.

  • Ipv6AddressIds: Daftar ID alamat IPv6 untuk instans ECS yang dibuat. Catatan: Atribut ini mengembalikan daftar dua dimensi. Jika suatu instans tidak memiliki alamat IPv6, elemen yang sesuai dalam daftar adalah daftar kosong. Jika tidak ada instans yang memiliki alamat IPv6, null dikembalikan.

  • Ipv6Addresses: Daftar alamat IPv6 untuk instans ECS yang dibuat. Catatan: Atribut ini mengembalikan daftar dua dimensi. Jika suatu instans tidak memiliki alamat IPv6, elemen yang sesuai dalam daftar adalah null. Jika tidak ada instans yang memiliki alamat IPv6, null dikembalikan.

Contoh

ROSTemplateFormatVersion: '2015-09-01'
Description: According the existing ECS instance, clone a set of ECS instanes with the same configuration(InstanceType, ImageId, InternetChargeType, InternetMaxBandwidthOut, system disk, data disk configurations, VPC properties). The user only needs to specify SourceInstanceId.
Parameters:
  SourceInstanceId:
    Type: String
    Description: The source ECS instance ID to be cloned
    Label: Source Instance ID
  InstanceName:
    Type: String
    Description: The instance name. The name must be 2 to 128 characters in length. It can contain letters, Chinese characters, digits, underscores (_), periods (.), and hyphens (-).
    ConstraintDescription: '[2, 128] characters, consists of uppercase letter, lowercase letter, number or special characters.'
    Label: Instance Name
    Default: ClonedECS
    MaxLength: 128
    MinLength: 2
  MaxAmount:
    Type: Number
    Description: The maximum number of ECS instances to create at a time. This value must be greater than or equal to the minimum number of ECS instances to create at a time.
    ConstraintDescription: An integer within [1, 100]
    Label: The Maximum of ECS Instances
    MaxValue: 100
    MinValue: 1
    Default: 1
  Password:
    Type: String
    Description: 'The password must be 8 to 30 characters in length. It must contain three of the following character types: uppercase letters, lowercase letters, digits, and special characters. Supported special characters: ( ) ` ~ ! @ # $ % ^  * - + = | { } [ ] : ; ‘ , . ? /.'
    ConstraintDescription: 'Length 8-30, must contain three of the following character types: uppercase letters, lowercase letters, digits, and special characters. Supported special characters: ()`~!@#$%^*_-+=|{}[]:;'',.?/'
    Label: ECS Instance Password
    MaxLength: 30
    MinLength: 8
    AllowedPattern: '[a-zA-Z0-9-\(\)\`\~\!@\#\$%\^\*-+=\|\{\}\[\]\:\;\‘\,\.\?\/]*'
    NoEcho: true
Metadata:
  ALIYUN::ROS::Interface:
    ParameterGroups:
      - Parameters:
          - InstanceName
          - SourceInstanceId
          - MaxAmount
          - Password
        Label:
          default: ECS
    TemplateTags:
      - acs:example:elastic-computing:Specify SourceInstanceId to clone a group of ECS instances with the same configuration.
Resources:
  ECSInstanceGroup:
    Type: ALIYUN::ECS::InstanceGroupClone
    Properties:
      SourceInstanceId:
        Ref: SourceInstanceId
      MaxAmount:
        Ref: MaxAmount
      Password:
        Ref: Password
Outputs:
  InstanceIds:
    Description: The instance ID list of created ecs instance
    Value:
      Fn::GetAtt:
        - ECSInstanceGroup
        - InstanceIds
  PublicIps:
    Description: Public IP address list of created ecs instance.
    Value:
      Fn::GetAtt:
        - ECSInstanceGroup
        - PublicIps
  ZoneIds:
    Description: Zone ID of created instance.
    Value:
      Fn::GetAtt:
        - ECSInstanceGroup
        - ZoneIds
{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Description": "According the existing ECS instance, clone a set of ECS instanes with the same configuration(InstanceType, ImageId, InternetChargeType, InternetMaxBandwidthOut, system disk, data disk configurations, VPC properties). The user only needs to specify SourceInstanceId.",
  "Parameters": {
    "SourceInstanceId": {
      "Type": "String",
      "Description": "The source ECS instance ID to be cloned",
      "Label": "Source Instance ID"
    },
    "InstanceName": {
      "Type": "String",
      "Description": "The instance name. The name must be 2 to 128 characters in length. It can contain letters, Chinese characters, digits, underscores (_), periods (.), and hyphens (-).",
      "ConstraintDescription": "[2, 128] characters, consists of uppercase letter, lowercase letter, number or special characters.",
      "Label": "Instance Name",
      "Default": "ClonedECS",
      "MaxLength": 128,
      "MinLength": 2
    },
    "MaxAmount": {
      "Type": "Number",
      "Description": "The maximum number of ECS instances to create at a time. This value must be greater than or equal to the minimum number of ECS instances to create at a time.",
      "ConstraintDescription": "An integer within [1, 100]",
      "Label": "The Maximum of ECS Instances",
      "MaxValue": 100,
      "MinValue": 1,
      "Default": 1
    },
    "Password": {
      "Type": "String",
      "Description": "The password must be 8 to 30 characters in length. It must contain three of the following character types: uppercase letters, lowercase letters, digits, and special characters. Supported special characters: ( ) ` ~ ! @ # $ % ^  * - + = | { } [ ] : ; ‘ , . ? /.",
      "ConstraintDescription": "Length 8-30, must contain three of the following character types: uppercase letters, lowercase letters, digits, and special characters. Supported special characters: ()`~!@#$%^*_-+=|{}[]:;',.?/",
      "Label": "ECS Instance Password",
      "MaxLength": 30,
      "MinLength": 8,
      "AllowedPattern": "[a-zA-Z0-9-\\(\\)\\`\\~\\!@\\#\\$%\\^\\*-+=\\|\\{\\}\\[\\]\\:\\;\\‘\\,\\.\\?\\/]*",
      "NoEcho": true
    }
  },
  "Metadata": {
    "ALIYUN::ROS::Interface": {
      "ParameterGroups": [
        {
          "Parameters": [
            "InstanceName",
            "SourceInstanceId",
            "MaxAmount",
            "Password"
          ],
          "Label": {
            "default": "ECS"
          }
        }
      ],
      "TemplateTags": [
        "acs:example:elastic-computing:Specify SourceInstanceId to clone a group of ECS instances with the same configuration."
      ]
    }
  },
  "Resources": {
    "ECSInstanceGroup": {
      "Type": "ALIYUN::ECS::InstanceGroupClone",
      "Properties": {
        "SourceInstanceId": {
          "Ref": "SourceInstanceId"
        },
        "MaxAmount": {
          "Ref": "MaxAmount"
        },
        "Password": {
          "Ref": "Password"
        }
      }
    }
  },
  "Outputs": {
    "InstanceIds": {
      "Description": "The instance ID list of created ecs instance",
      "Value": {
        "Fn::GetAtt": [
          "ECSInstanceGroup",
          "InstanceIds"
        ]
      }
    },
    "PublicIps": {
      "Description": "Public IP address list of created ecs instance.",
      "Value": {
        "Fn::GetAtt": [
          "ECSInstanceGroup",
          "PublicIps"
        ]
      }
    },
    "ZoneIds": {
      "Description": "Zone ID of created instance.",
      "Value": {
        "Fn::GetAtt": [
          "ECSInstanceGroup",
          "ZoneIds"
        ]
      }
    }
  }
}