All Products
Search
Document Center

Server Load Balancer:ModifyCapacityReservation

Last Updated:Sep 28, 2026

Membuat atau mengubah reservasi kapasitas.

Deskripsi operasi

ModifyCapacityReservation adalah operasi asinkron. Sistem mengembalikan ID permintaan, tetapi reservasi kapasitas belum selesai dan tugas reservasi terus berjalan di latar belakang. Anda dapat memanggil DescribeCapacityReservation untuk mengkueri status reservasi kapasitas:

  • Pending: Reservasi kapasitas sedang berlangsung.

  • Provisioned: Reservasi kapasitas telah selesai.

  • Rebalancing: Reservasi kapasitas sedang didistribusikan ulang di seluruh 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. Sebelum Anda mengonfigurasi reservasi kapasitas, instans harus memiliki setidaknya satu Pendengar dalam status Running.

alb-iv9gj3spak6fbj****

ResetCapacityReservation

boolean

No

Apakah akan membatalkan reservasi kapasitas. Nilai valid:

  • true: Membatalkan reservasi kapasitas.

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

false

MinimumLoadBalancerCapacity

object

No

Kapasitas load balancer cadangan minimum.

CapacityUnits

integer

No

Jumlah LCU yang dicadangkan per jam.

100

DryRun

boolean

No

Apakah akan menjalankan dry run. Nilai valid:

  • true: Mengirim permintaan dry run tanpa mencadangkan sumber daya. Sistem memeriksa parameter wajib, format permintaan, dan batas layanan. Jika pemeriksaan gagal, kode kesalahan yang sesuai akan dikembalikan. Jika pemeriksaan berhasil, kode kesalahan DryRunOperation akan dikembalikan.

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

Valid values:

  • true :

    true.

  • false :

    false.

false

ClientToken

string

No

Token Klien yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan Klien untuk menghasilkan token, tetapi Anda harus memastikan bahwa token tersebut unik di antara permintaan yang berbeda. Token hanya dapat berisi karakter ASCII dan panjangnya tidak boleh melebihi 64 karakter.

Catatan

Jika Anda tidak menentukan parameter ini, sistem akan menggunakan RequestId dari permintaan API sebagai ClientToken. RequestId mungkin berbeda untuk setiap permintaan API.

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

Elemen respons

Element

Type

Description

Example

object

Skema Tanggapan.

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. Instans tidak memiliki pendengar dalam status berjalan.
400 OperationDenied.CapacityReservationNotSupport Resource reservation is not supported. Fitur Pemesanan sumber daya tidak didukung.
400 OperationDenied.CapacityUnitsBelowMinimum The operation is not allowed because of CapacityUnitsBelowMinimum. LCU terjadwal tidak memenuhi persyaratan minimum.
400 OperationDenied.CapacityDecreaseRequestLimitExceeded The operation is not allowed because of CapacityDecreaseRequestLimitExceeded. Jumlah penurunan level atau pembatalan untuk Sumber daya Instans terjadwal telah melebihi batas.
400 OperationDenied.PriorRequestNotComplete The operation is not allowed because of PriorRequestNotComplete. Permintaan pemesanan sumber daya sebelumnya belum selesai.
400 OperationDenied.DeploymentSetExists The operation is not allowed because of OperationDenied.DeploymentSetExists. Pemesanan sumber daya yang terkait dengan set penyebaran tidak dapat dimodifikasi.
400 OperationDenied.DeploymentSetIsEmpty The operation is not allowed because of OperationDenied.DeploymentSetIsEmpty. Set penyebaran tidak berisi instans ECS apa pun.
400 OperationDenied.DeploymentSetsConflicts The operation is not allowed because of OperationDenied.DeploymentSetsConflicts. Zona instans ECS dalam set penyebaran bertentangan dengan zona instans ALB.
400 OperationDenied.DeploymentSetsNotSupport The operation is not allowed because of OperationDenied.DeploymentSetsNotSupport. Fitur set penyebaran tidak didukung.
400 OperationDenied.DeploymentSetsStrategyNotMatch The operation is not allowed because of DeploymentSetsStrategyNotMatch. Kebijakan set penyebaran tidak cocok. Hanya set penyebaran dengan kebijakan latensi rendah jaringan yang didukung.
400 QuotaExceeded.ReservationMaxLcuPerLb The quota of %s is exceeded, usage %s/%s. Kuota %s telah terlampaui. Nilai saat ini adalah %s, dan nilai kuota adalah %s.
400 QuotaExceeded.ReservationMaxLcuPerRegion The quota of %s is exceeded, usage %s/%s. Kuota %s telah terlampaui. Nilai saat ini adalah %s, dan nilai kuota adalah %s.
400 QuotaExceeded.DeploymentSetsNum The quota of %s is exceeded, usage %s/%s. Kuota %s telah terlampaui. Nilai saat ini adalah %s, dan nilai kuota adalah %s.
400 OperationDenied.DeploymentSetsNotSharedToAlb DeploymentSets are not shared to alb. Set penyebaran tidak dibagikan ke ALB.
404 ResourceNotFound.LoadBalancer The specified resource of %s is not found. Sumber daya %s tidak ada.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.