All Products
Search

This Product

    Server Load Balancer:ModifyCapacityReservation

    Document Center

    Server Load Balancer:ModifyCapacityReservation

    Last Updated:Dec 19, 2025

    Membuat dan memperbarui reservasi Load Balancer Capacity Unit (LCU).

    Deskripsi operasi

    ModifyCapacityReservation adalah operasi asinkron. Setelah mengirim permintaan, sistem akan mengembalikan ID permintaan dan menjalankan tugas tersebut di latar belakang. Reservasi LCU tidak diperbarui secara langsung. Anda dapat memanggil operasi DescribeCapacityReservation untuk mengecek status reservasi LCU:

    • Jika reservasi LCU berada dalam status Pending, reservasi sedang dalam proses pembuatan.

    • Jika reservasi LCU berada dalam status Provisioned, reservasi telah berhasil dibuat.

    • Jika reservasi LCU berada dalam status Rebalancing, reservasi sedang diseimbangkan ulang di berbagai zona.

    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

    Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

    Sintaks permintaan

    POST  HTTP/1.1

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    LoadBalancerId

    string

    Yes

    ID instans Application Load Balancer (ALB).

    alb-iv9gj3spak6fbj****
    ResetCapacityReservation

    boolean

    No

    Menentukan apakah akan membatalkan reservasi LCU. Nilai yang valid:

    • true: Membatalkan reservasi LCU.

    • false (default): Tidak membatalkan reservasi LCU. Anda tidak perlu menentukan parameter ini saat membuat atau memperbarui reservasi LCU.

    false
    MinimumLoadBalancerCapacity

    object

    No

    Nilai LCU minimum yang akan diresevasi.

    CapacityUnits

    integer

    No

    Jumlah LCU yang akan diresevasi per jam.

    100
    DryRun

    boolean

    No

    Menentukan apakah akan melakukan dry run. Nilai yang valid:

    • true: Mengirim permintaan pemeriksaan tetapi tidak mereservasi resource apa pun. Sistem memeriksa permintaan terhadap parameter yang diperlukan, format, dan batas layanan. Jika pemeriksaan gagal, kesalahan dikembalikan. Jika pemeriksaan berhasil, kode kesalahan DryRunOperation dikembalikan.

    • false (default): Mengirim permintaan normal. Setelah permintaan lolos pemeriksaan, kode status HTTP 2xx dikembalikan dan operasi dilakukan.

    Valid values:

    • true :

      true

    • false :

      false

    false
    ClientToken

    string

    No

    Token klien untuk memastikan idempotensi permintaan. Hasilkan token dari klien Anda dan pastikan token tersebut unik di antara permintaan yang berbeda. Token hanya boleh berisi karakter ASCII dan panjangnya tidak boleh melebihi 64 karakter.

    Catatan

    Jika parameter ini tidak ditentukan, sistem menggunakan RequestId sebagai ClientToken. RequestId setiap permintaan API berbeda-beda.

    5A2CFF0E-5718-45B5-9D4D-70B3FF3898

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Skema respons.

    RequestId

    string

    ID permintaan.

    593B0448-D13E-4C56-AC0D-FDF0F******

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "593B0448-D13E-4C56-AC0D-FDF0F******"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 OperationDenied.ListenerNotFound The operation is not allowed because of ListenerNotFound.
    400 OperationDenied.CapacityReservationNotSupport Resource reservation is not supported.
    400 OperationDenied.CapacityUnitsBelowMinimum The operation is not allowed because of CapacityUnitsBelowMinimum.
    400 OperationDenied.CapacityDecreaseRequestLimitExceeded The operation is not allowed because of CapacityDecreaseRequestLimitExceeded.
    400 OperationDenied.PriorRequestNotComplete The operation is not allowed because of PriorRequestNotComplete.
    400 OperationDenied.DeploymentSetExists The operation is not allowed because of OperationDenied.DeploymentSetExists.
    400 OperationDenied.DeploymentSetIsEmpty The operation is not allowed because of OperationDenied.DeploymentSetIsEmpty.
    400 OperationDenied.DeploymentSetsConflicts The operation is not allowed because of OperationDenied.DeploymentSetsConflicts.
    400 OperationDenied.DeploymentSetsNotSupport The operation is not allowed because of OperationDenied.DeploymentSetsNotSupport.
    400 OperationDenied.DeploymentSetsStrategyNotMatch The operation is not allowed because of DeploymentSetsStrategyNotMatch.
    400 QuotaExceeded.ReservationMaxLcuPerLb The quota of %s is exceeded, usage %s/%s.
    400 QuotaExceeded.ReservationMaxLcuPerRegion The quota of %s is exceeded, usage %s/%s.
    400 QuotaExceeded.DeploymentSetsNum The quota of %s is exceeded, usage %s/%s.
    404 ResourceNotFound.LoadBalancer The specified resource of %s is not found. The specified resource of %s is not found.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.