All Products
Search

This Product

    Server Load Balancer:ModifyCapacityReservation

    Document Center

    Server Load Balancer:ModifyCapacityReservation

    Last Updated:Jun 10, 2026

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

    Deskripsi operasi

    ModifyCapacityReservation is an asynchronous operation. After you send a request, the system returns a request ID and runs the task in the background. The LCU reservation is not immediately updated. You can call the DescribeCapacityReservation operation to query the status of an LCU reservation:

    • If an LCU reservation is in the Pending state, it is being created.

    • If an LCU reservation is in the Provisioned state, it is created.

    • If an LCU reservation is in the Rebalancing state, it is being rebalanced across zones.

    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

    Apakah akan membatalkan reservasi LCU. Nilai 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 direservasi.

    CapacityUnits

    integer

    No

    The number of LCUs to reserve per hour.

    100
    DryRun

    boolean

    No

    Apakah akan menjalankan dry run. Nilai valid:

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

    • false (default): Mengirim permintaan Normal. Setelah permintaan lolos pemeriksaan, kode status HTTP 2xx dikembalikan lalu operasi dijalankan.

    false
    ClientToken

    string

    No

    token Klien untuk memastikan idempotensi permintaan. Buat token dari Klien Anda lalu pastikan token tersebut unik di antara permintaan yang berbeda. token hanya dapat berisi karakter ASCII dan tidak boleh melebihi 64 karakter.

    Catatan

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

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

    Elemen respons

    Element

    Type

    Description

    Example

    object

    The schema of the response.

    RequestId

    string

    The request ID.

    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.
    400 OperationDenied.DeploymentSetsNotSharedToAlb DeploymentSets are not shared to alb.
    404 ResourceNotFound.LoadBalancer The specified resource of %s is not found.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.