All Products
Search
Document Center

Auto Scaling:AttachInstances

Last Updated:Jun 12, 2026

Menambahkan instans secara manual ke grup penskalaan. Anda dapat menambahkan Instance ECS, instans kontainer elastis, atau instans terkelola yang tidak berada dalam grup penskalaan, atau memulai ulang Instance ECS yang berada dalam mode ekonomis di dalam grup penskalaan untuk mengembalikannya ke status layanan.

Deskripsi operasi

  • Sebelum Anda memanggil operasi ini, pastikan kondisi berikut terpenuhi:
    • Grup penskalaan berada dalam status Active.

    • Tidak ada aktivitas penskalaan yang sedang dieksekusi di dalam grup penskalaan.

  • Batasan berikut berlaku untuk Instance ECS atau instans kontainer elastis yang ingin Anda tambahkan ke grup penskalaan:
    • Instans harus berada di wilayah yang sama dengan grup penskalaan.

    • Instans harus berada dalam status Running.

    • Instans tidak boleh sudah menjadi milik grup penskalaan lain.

    • Tipe pembayaran instans harus berupa langganan, pay-as-you-go, atau spot instans.

    • Jika VswitchID ditentukan untuk grup penskalaan, Instance ECS atau instans kontainer elastis dengan jenis jaringan klasik atau dari VPC yang berbeda tidak dapat ditambahkan ke grup penskalaan.

    • Jika VswitchID tidak ditentukan untuk grup penskalaan, Instance ECS atau instans kontainer elastis dengan jenis jaringan VPC tidak dapat ditambahkan ke grup penskalaan.

  • Batasan berikut berlaku untuk instans terkelola yang ingin Anda tambahkan ke grup penskalaan:
    • Instans terkelola harus berada di wilayah yang sama dengan grup penskalaan.

    • Hanya instans terkelola yang tidak menjadi milik grup penskalaan mana pun yang dapat ditambahkan ke grup penskalaan tipe ECS.

    • Instans terkelola tidak mendukung kait siklus hidup, asosiasi load balancing, atau fitur pemeriksaan kesehatan.

    • Setelah instans terkelola ditambahkan ke grup penskalaan tipe ECS, grup penskalaan tidak mengelola siklus hidup instans terkelola tersebut.

    • Instans terkelola hanya dapat ditambahkan ke atau dihapus dari grup penskalaan secara manual. Instans terkelola tidak dilepaskan saat dihapus.

  • Perhatikan hal-hal berikut:
    • Saat tidak ada aktivitas penskalaan yang sedang dieksekusi di dalam grup penskalaan, operasi ini dapat melewati pengatur waktu pendinginan dan dieksekusi secara langsung.

    • Pemanggilan operasi ini yang berhasil hanya menunjukkan bahwa Penyesuaian Skala Otomatis telah menerima permintaan. Aktivitas penskalaan dapat dieksekusi, tetapi eksekusi yang berhasil tidak dijamin. Anda dapat memeriksa status eksekusi aktivitas penskalaan berdasarkan ScalingActivityId yang dikembalikan.

    • Jika jumlah instans yang ditentukan dalam operasi ini ditambah dengan kapasitas total saat ini dari grup penskalaan melebihi nilai MaxSize, pemanggilan akan gagal.

    • Instance ECS, instans kontainer elastis, atau instans terkelola yang ditambahkan secara manual melalui operasi ini tidak dikaitkan dengan konfigurasi penskalaan aktif dari grup penskalaan.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

  • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

  • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

  • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

  • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

    • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

    • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

  • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

  • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

ess:AttachInstances

update

*ScalingGroup

acs:ess:{#regionId}:{#accountId}:scalinggroup/{#ScalingGroupId}

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

ScalingGroupId

string

Yes

ID grup penskalaan.

asg-bp18p2yfxow2dloq****

Entrusted

boolean

No

Apakah akan menyerahkan siklus hidup instans ke grup penskalaan saat Anda menambahkan instans yang ada secara manual ke grup penskalaan. Nilai valid:

  • true: Siklus hidup instans dikelola oleh Penyesuaian Skala Otomatis, konsisten dengan instans yang dibuat secara otomatis oleh grup penskalaan. Instans dilepaskan secara otomatis saat dihapus dari grup penskalaan, kecuali saat dihapus dengan memanggil operasi DetachInstances.

  • false: Siklus hidup instans tidak dikelola oleh grup penskalaan. Instans tidak dilepaskan saat dihapus dari grup penskalaan.

Catatan

Parameter ini tidak didukung untuk instans langganan, instans terkelola, atau instans dalam mode ekonomis di dalam grup penskalaan.

Nilai default: false.

false

InstanceIds

array

No

ID Instance ECS, instans kontainer elastis, instans terkelola, atau instans dalam mode ekonomis di dalam grup penskalaan yang ingin Anda tambahkan.

string

No

ID instans Instance ECS, instans kontainer elastis, instans terkelola, atau instans dalam mode ekonomis di dalam grup penskalaan yang ingin Anda tambahkan.

Contoh:

  • ID Instance ECS yang akan ditambahkan: i-28wt4****.

  • ID instans kontainer elastis yang akan ditambahkan: eci-bp17gw49eu09yiwm****.

  • ID instans terkelola yang akan ditambahkan: mi-2cx*****.

  • ID instans dalam mode ekonomis di dalam grup penskalaan yang akan dimulai ulang: i-2cd2f****.

Catatan

Hanya satu jenis instans yang dapat diproses dalam satu permintaan pemanggilan.

i-28wt4****

LoadBalancerWeights

array

No

Bobot Instance ECS atau instans kontainer elastis sebagai server backend instans load balancing yang terkait.

integer

No

Pengaturan untuk bobot Instance ECS atau instans kontainer elastis sebagai server backend instans load balancing yang terkait. Nilai valid: 1 hingga 100.

Catatan

Parameter ini tidak didukung untuk instans terkelola atau instans dalam mode ekonomis di dalam grup penskalaan.

Nilai default: 50.

50

LifecycleHook

boolean

No

Apakah akan memicu kait siklus hidup scale-out saat instans ditambahkan ke grup penskalaan. Nilai valid:

  • true: Kait siklus hidup dipicu.

  • false: Kait siklus hidup tidak dipicu.

Catatan

Parameter ini tidak didukung untuk instans terkelola atau instans dalam mode ekonomis di dalam grup penskalaan.

Nilai default: false.

false

RegionId

string

No

ID wilayah grup penskalaan.

cn-qingdao

ClientToken

string

No

Token klien yang digunakan untuk memastikan idempotensi permintaan.

Anda dapat menggunakan klien untuk menghasilkan token, tetapi pastikan token tersebut unik di antara permintaan yang berbeda. Token hanya dapat berisi karakter ASCII dan panjangnya tidak boleh melebihi 64 karakter. Untuk informasi lebih lanjut, lihat Cara memastikan idempotensi.

123e4567-e89b-12d3-a456-42665544****

IgnoreInvalidInstance

boolean

No

Apakah akan mengabaikan instans tidak valid saat menambahkan batch instans ke grup penskalaan. Nilai valid:

  • true: Instans tidak valid diabaikan. Jika terdapat instans tidak valid dan instans valid berhasil ditambahkan, status aktivitas penskalaan ditampilkan sebagai Warning. Anda dapat melihat instans tidak valid di detail aktivitas penskalaan.

  • false: Instans tidak valid tidak diabaikan. Jika ada instans dalam batch yang tidak valid, permintaan akan mengembalikan error.

Nilai default: false.

false

Elemen respons

Element

Type

Description

Example

object

ScalingActivityId

string

ID aktivitas penskalaan.

asa-bp1crxor24s28xf1****

RequestId

string

ID permintaan.

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Contoh

Respons sukses

JSONformat

{
  "ScalingActivityId": "asa-bp1crxor24s28xf1****",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

500 InternalError The request processing has failed due to some unknown error, exception or failure.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.