All Products
Search

This Product

    Auto Scaling:ScaleWithAdjustment

    Document Center

    Auto Scaling:ScaleWithAdjustment

    Last Updated:Sep 10, 2026

    Memicu skalabilitas elastis berdasarkan aturan penyesuaian yang ditentukan.

    Deskripsi operasi

    Deskripsi operasi

    • Sebelum memanggil operasi ini, pastikan kondisi berikut terpenuhi:

      • Grup penskalaan berada dalam status Active.

      • Tidak ada aktivitas penskalaan yang sedang berlangsung di grup penskalaan.

    • Jika tidak ada aktivitas penskalaan yang sedang berlangsung di grup penskalaan, operasi ini dapat melewati waktu pendinginan dan langsung memicu aktivitas penskalaan.

    • Jika jumlah instans ECS yang akan ditambahkan berdasarkan aturan penskalaan ditambah jumlah instans saat ini di grup penskalaan (Total Capacity) lebih besar dari jumlah instans maksimum (MaxSize), aktivitas penskalaan akan dilakukan dengan Total Capacity diatur ke MaxSize.

    • Jika jumlah instans saat ini di grup penskalaan (Total Capacity) dikurangi jumlah instans ECS yang akan dihapus berdasarkan aturan penskalaan kurang dari jumlah instans minimum (MinSize), aktivitas penskalaan akan dilakukan dengan Total Capacity diatur ke MinSize.

    Tanggapan yang berhasil hanya menunjukkan bahwa Penyesuaian Skala Otomatis telah menerima permintaan dan dapat melakukan aktivitas penskalaan. Ini tidak berarti bahwa aktivitas penskalaan akan berhasil. Anda dapat memeriksa status eksekusi aktivitas penskalaan berdasarkan ScalingActivityId yang dikembalikan.

    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:ScaleWithAdjustment

    update

    *ScalingGroup

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

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    ScalingGroupId

    string

    Yes

    ID grup penskalaan.

    asg-j6c1o397427hyjdc****
    AdjustmentType

    string

    Yes

    Metode penyesuaian aktivitas penskalaan. Nilai valid:

    • QuantityChangeInCapacity: Menambahkan atau menghapus sejumlah instans ECS yang ditentukan.

    • PercentChangeInCapacity: Menambahkan atau menghapus persentase instans ECS yang ditentukan.

    • TotalCapacity: Menyesuaikan jumlah instans ECS di grup penskalaan saat ini ke nilai yang ditentukan.

    QuantityChangeInCapacity
    AdjustmentValue

    integer

    Yes

    Nilai penyesuaian aktivitas penskalaan. Jumlah instans ECS yang disesuaikan dalam satu aktivitas penskalaan tidak boleh melebihi 1000. Jika tidak, penyesuaian akan gagal. Nilai valid untuk metode penyesuaian yang berbeda:

    • QuantityChangeInCapacity: -1000 hingga 1000.

    • PercentChangeInCapacity: -100 hingga 10000.

    • TotalCapacity: 0 hingga 2000.

    100
    MinAdjustmentMagnitude

    integer

    No

    Jumlah instans minimum yang akan disesuaikan dalam aktivitas penskalaan. Parameter ini hanya berlaku ketika AdjustmentType diatur ke PercentChangeInCapacity.

    1
    ClientToken

    string

    No

    Token klien yang digunakan untuk memastikan idempotensi permintaan dan mencegah pengiriman berulang. Nilai dihasilkan oleh klien dan harus unik di berbagai permintaan. Panjang nilai dapat mencapai 64 karakter ASCII dan tidak boleh mengandung karakter non-ASCII.

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

    boolean

    No

    Apakah akan mengeksekusi aktivitas penskalaan secara sinkron. Parameter ini hanya valid untuk grup penskalaan yang telah mengonfigurasi jumlah instans yang diharapkan. Nilai valid:

    • true: Eksekusi sinkron. Aturan penskalaan langsung memicu aktivitas penskalaan grup penskalaan.

    • false: Eksekusi asinkron. Ketika jumlah instans yang diharapkan di grup penskalaan dimodifikasi, aktivitas penskalaan tidak langsung memicu. Sistem menunggu hingga mendeteksi perbedaan antara jumlah instans yang diharapkan dan jumlah instans saat ini di grup penskalaan, lalu memicu aktivitas penskalaan.

    Catatan

    Untuk informasi lebih lanjut tentang jumlah instans yang diharapkan, lihat Jumlah instans yang diharapkan.

    Nilai default: false.

    false
    Overrides

    object

    No

    Parameter penggantian untuk scale-out di grup penskalaan tipe ECI.

    Cpu

    number

    No

    Jumlah vCPU di tingkat instans. Unit: cores.

    2
    Memory

    number

    No

    Ukuran memori di tingkat instans. Unit: GiB.

    4
    UserData

    string

    No

    ContainerOverride

    array<object>

    No

    Parameter penggantian untuk daftar kontainer.

    array<object>

    No

    Parameter penggantian untuk daftar kontainer.

    Command

    array

    No

    Perintah startup kontainer. Mendukung maksimum 20 perintah. Setiap perintah dapat berisi hingga 256 karakter.

    string

    No

    Perintah startup kontainer. Mendukung maksimum 20 perintah. Setiap perintah dapat berisi hingga 256 karakter.

    sleep
    Memory

    number

    No

    Ukuran memori kontainer. Unit: GiB.

    4
    Arg

    array

    No

    Argumen untuk perintah startup kontainer. Mendukung maksimum 10 argumen.

    string

    No

    Argumen untuk perintah startup kontainer. Mendukung maksimum 10 argumen.

    arg
    Cpu

    number

    No

    Jumlah vCPU kontainer. Unit: cores.

    2
    EnvironmentVar

    array<object>

    No

    Daftar informasi Variabel lingkungan.

    object

    No

    Daftar informasi Variabel lingkungan.

    Value

    string

    No

    Environment variable value. Length: 0 to 256 characters.

    /usr/local/tomcat
    Key

    string

    No

    Environment variable name. Length: 1 to 128 characters. Format requirements: [0-9a-zA-Z] and underscores (_); must not start with a digit.

    PATH
    Name

    string

    No

    Nama kontainer. Jika Anda ingin mengganti parameter kontainer, Anda harus menentukan nama kontainer. Parameter kontainer hanya dapat diganti ketika nama kontainer cocok dengan nama kontainer di konfigurasi penskalaan.

    container-1
    LifecycleHookContext

    object

    No

    Informasi konteks kait siklus hidup.

    DisableLifecycleHook

    boolean

    No

    Apakah akan menonaktifkan semua fitur kait siklus hidup untuk aktivitas penskalaan. Nilai valid:

    • true: Dinonaktifkan.

    • false: Tidak dinonaktifkan.

    false
    IgnoredLifecycleHookIds

    array

    No

    Daftar ID kait siklus hidup yang akan dinonaktifkan untuk aktivitas penskalaan.

    string

    No

    Daftar ID kait siklus hidup yang akan dinonaktifkan untuk aktivitas penskalaan.

    ash-bp14zolna43z266bq***
    LifecycleHookResult

    string

    No

    ActivityMetadata

    string

    No

    Metadata aktivitas penskalaan.

    {"key":"value"}
    ExecutionMode

    string

    No

    Mode eksekusi. Nilai valid:

    • None: Tidak ditentukan. Penskalaan Normal dilakukan.

    • PlanOnly: Penskalaan tidak dipicu. Hanya perencanaan elastis yang dilakukan, dan hasil perencanaan dikembalikan di PlanResult, termasuk Tipe instans, ID zona, metode penagihan, dan jumlah instans yang akan dibuat.

    Nilai default: None.

    PlanOnly

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Parameter tanggapan untuk memicu skalabilitas elastis berdasarkan aturan penyesuaian yang ditentukan.

    ScalingActivityId

    string

    ID aktivitas penskalaan.

    asa-bp175o6f6ego3r2j****
    RequestId

    string

    ID permintaan.

    473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
    ActivityType

    string

    Tipe aktivitas penskalaan.

    Jika ActivityType diatur ke CapacityChange, aktivitas penskalaan yang sesuai dengan ScalingActivityId yang dikembalikan hanya memodifikasi jumlah instans yang diharapkan di grup penskalaan tanpa langsung melakukan penskalaan.

    Ruang lingkup yang berlaku: grup penskalaan dengan jumlah instans yang diharapkan telah dikonfigurasi.

    CapacityChange
    PlanResult

    object

    Hasil perencanaan elastis yang dikembalikan ketika ExecutionMode diatur ke PlanOnly.

    ResourceAllocations

    array<object>

    Informasi alokasi sumber daya dalam hasil perencanaan elastis.

    object

    ZoneId

    string

    Zone ID.

    cn-beijing-g
    InstanceType

    string

    Instance type.

    ecs.u1-c1m8.large
    SpotStrategy

    string

    The spot strategy of the instance. Valid values:

    • NoSpot: A normal pay-as-you-go instance.

    • SpotWithPriceLimit: A spot instance with a specified maximum price.

    • SpotAsPriceGo: A spot instance for which the system automatically bids based on the current marketplace price.

    NoSpot
    Amount

    integer

    Number of instances.

    1
    InstanceChargeType

    string

    Billing method. Valid return values are as follows:

    • Prepaid: subscription.

    • Postpaid: pay-as-you-go.

    Postpaid

    Contoh

    Respons sukses

    JSONformat

    {
  "ScalingActivityId": "asa-bp175o6f6ego3r2j****",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "ActivityType": "CapacityChange",
  "PlanResult": {
    "ResourceAllocations": [
      {
        "ZoneId": "cn-beijing-g",
        "InstanceType": "ecs.u1-c1m8.large",
        "SpotStrategy": "NoSpot",
        "Amount": 1,
        "InstanceChargeType": "Postpaid"
      }
    ]
  }
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    403 Forbidden.Forbidden Operation Forbidden

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.