All Products
Search
Document Center

Server Load Balancer:UpdateLoadBalancerZones

Last Updated:Jun 10, 2026

Mengubah zona instans Application Load Balancer (ALB).

Deskripsi operasi

UpdateLoadBalancerZones is an asynchronous API. After you send a request, the system returns a request ID but does not immediately modify the availability zones. The modification runs in the background. Call the GetLoadBalancerAttribute operation to query the modification status:

  • If the ALB instance is in the Configuring state, the modification is in progress.

  • If the ALB instance is in the Active state, the modification is complete.

Catatan

Calling this operation may incur fees.

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

alb:UpdateLoadBalancerZones

update

*LoadBalancer

acs:alb:{#regionId}:{#accountId}:loadbalancer/{#loadbalancerId}

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

ClientToken

string

No

Token klien yang digunakan untuk memastikan idempotensi permintaan.

Hasilkan token unik dari klien Anda untuk setiap permintaan. Parameter ClientToken hanya dapat berisi karakter ASCII.

Catatan

Jika Anda tidak menentukan parameter ini, sistem secara otomatis menggunakan RequestId permintaan sebagai ClientToken. RequestId berbeda untuk setiap permintaan API.

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

DryRun

boolean

No

Apakah akan menjalankan dry run. Nilai valid:

  • true: Menjalankan dry run untuk memeriksa potensi masalah, termasuk parameter yang hilang, format yang salah, dan batas layanan. Jika permintaan gagal pada dry run, sistem mengembalikan Paket kesalahan. Jika permintaan lolos dry run, sistem mengembalikan kode kesalahan DryRunOperation.

  • false (default): Mengirimkan permintaan. Jika permintaan lolos pemeriksaan, sistem mengembalikan kode status HTTP 2xx dan menjalankan operasi.

true

LoadBalancerId

string

Yes

ID instans ALB.

alb-o9ulmq5hfn68jk****

ZoneMappings

array<object>

Yes

Pemetaan antara zona dan vSwitch. Anda dapat menentukan hingga 10 zona. Jika wilayah saat ini mendukung dua zona atau lebih, Anda harus menentukan setidaknya dua zona. Menentukan parameter ini akan menimpa konfigurasi zona yang ada.

object

No

The mapping between an availability zone and a VSwitch.

VSwitchId

string

Yes

The ID of the VSwitch in the availability zone. Each availability zone uses one VSwitch and one subnet by default.

vsw-bp1rmcrwg3srh1fh8****

ZoneId

string

Yes

The ID of the availability zone. You can call the DescribeZones operation to query the IDs of available zones.

cn-hangzhou-a

EipType

string

No

The type of the EIP. Valid values:

  • Common: an EIP.

  • Anycast: an Anycast EIP.

Catatan

For a list of regions that support binding an Anycast EIP to an ALB instance, see Usage limits.

Common

IntranetAddress

string

No

The private IPv4 address.

192.168.10.1

RetainResourceType

array

No

string

No

eip

Elemen respons

Element

Type

Description

Example

object

The response object.

JobId

string

The job ID.

72dcd26b-f12d-4c27-b3af-18f6aed5****

RequestId

string

The request ID.

CEF72CEB-54B6-4AE8-B225-F876FF7BA984

Contoh

Respons sukses

JSONformat

{
  "JobId": "72dcd26b-f12d-4c27-b3af-18f6aed5****",
  "RequestId": "CEF72CEB-54B6-4AE8-B225-F876FF7BA984"
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

400 IncorrectStatus.LoadBalancer The status of %s [%s] is incorrect.
400 IncorrectBusinessStatus.LoadBalancer The business status of %s [%s]  is incorrect.
400 IncorrectBusinessStatus.Eip The business status of %s [%s]  is incorrect.
400 OperationDenied.ZoneVSwitchChanged The operation is not allowed because of %s.
400 OperationDenied.ZoneMappingsNotChanged The operation is not allowed because of %s.
400 ResourceNotEnough.VSwitchIp The specified resource %s is not enough.
400 Mismatch.ZoneIdAndVSwitchId The %s and %s are mismatched.
404 ResourceNotFound.LoadBalancer The specified resource %s is not found.
404 ResourceNotFound.VSwitch The specified resource %s is not found.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.