Gunakan UpdateServerGroupServersAttribute untuk memodifikasi berat dan deskripsi server backend dalam grup server - Server Load Balancer - Alibaba Cloud - Server Load Balancer

Mengubah bobot dan deskripsi server backend dalam grup server pada instans Network Load Balancer (NLB).

Deskripsi operasi

UpdateServerGroupServersAttribute adalah operasi asinkron. Setelah permintaan dikirim, sistem mengembalikan ID permintaan dan menjalankan tugas di latar belakang.

Anda dapat memanggil operasi ListServerGroups untuk mendapatkan status grup server.
- Jika grup server berada dalam status Configuring, grup server sedang diubah.
- Jika grup server berada dalam status Available, grup server sedang berjalan.
Anda dapat memanggil operasi ListServerGroupServers untuk mendapatkan status server backend.
- Jika server backend berada dalam status Configuring, ini menunjukkan bahwa server backend sedang diubah.
- Jika server backend berada dalam status Available, ini menunjukkan bahwa server backend sedang berjalan.

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

nlb:UpdateServerGroupServersAttribute

update

*ServerGroup

acs:nlb:{#regionId}:{#accountId}:servergroup/{#ServerGroupId}

None

Parameter permintaan

Parameter	Type	Required	Description	Example
ServerGroupId	string	Yes	ID grup server.	sgp-atstuj3rtoptyui****
Servers	array<object>	Yes	Server backend. Anda dapat menentukan paling banyak 200 server backend dalam setiap pemanggilan.
	object	No	Server backend. Anda dapat menentukan paling banyak 200 server backend dalam setiap pemanggilan.
ServerId	string	Yes	ID server backend. Jika grup server bertipe Instance, atur parameter ini ke ID server bertipe Ecs, Eni, atau Eci. Jika grup server bertipe Ip, atur parameter ini ke alamat IP.	ecs-bp67acfmxazb4p****
ServerType	string	Yes	Tipe server backend. Nilai yang valid: Ecs: instans Elastic Compute Service (ECS) Eni: elastic network interface (ENI) Eci: elastic container instance Ip: alamat IP	Ecs
ServerIp	string	No	Alamat IP server. Jika tipe grup server adalah Ip, atur parameter ServerId ke alamat IP.	192.168.6.6
Port	integer	Yes	Port yang digunakan oleh server backend. Nilai yang valid: 1 hingga 65535. Catatan Parameter ini tidak dapat diubah.	443
Weight	integer	No	Bobot server backend. Nilai yang valid: 0 hingga 100. Nilai default: 100. Jika nilai diatur ke 0, tidak ada permintaan yang diteruskan ke server.	100
Description	string	No	Deskripsi server backend. Deskripsi harus terdiri dari 2 hingga 256 karakter, dan dapat berisi huruf, angka, koma (,), titik (.), titik koma (;), garis miring (/), tanda at (@), garis bawah (_), dan tanda hubung (-).	test
RegionId	string	No	ID wilayah instans NLB. Anda dapat memanggil operasi DescribeRegions untuk mendapatkan daftar wilayah terbaru.	cn-hangzhou
DryRun	boolean	No	Menentukan apakah akan melakukan dry run, tanpa mengirim permintaan sebenarnya. Nilai yang valid: true: hanya melakukan dry run. Sistem memeriksa permintaan untuk potensi masalah, termasuk nilai parameter yang hilang, sintaks permintaan yang salah, dan batasan layanan. Jika permintaan gagal dry run, pesan kesalahan akan dikembalikan. Jika permintaan lulus dry run, kode kesalahan `DryRunOperation` akan dikembalikan. false (default): melakukan dry run dan mengirim permintaan sebenarnya. Jika permintaan lulus dry run, kode status HTTP 2xx akan dikembalikan dan operasi dijalankan.	false
ClientToken	string	No	Token klien yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan klien untuk menghasilkan nilai ini. Pastikan nilainya unik di antara semua permintaan. Hanya karakter ASCII yang diperbolehkan. Catatan Jika Anda tidak menentukan parameter ini, nilai RequestId akan digunakan.** RequestId** dari setiap permintaan berbeda.	123e4567-e89b-12d3-a456-426655440000

Elemen respons

Element	Type	Description	Example
	object	Memperbarui konfigurasi server backend dalam grup server.
RequestId	string	ID permintaan.	54B48E3D-DF70-471B-AA93-08E683A1B45
ServerGroupId	string	ID grup server.	sgp-atstuj3rtoptyui****
JobId	string	ID tugas asinkron.	72dcd26b-f12d-4c27-b3af-18f6aed5****

Contoh

Respons sukses

JSONformat

{
  "RequestId": "54B48E3D-DF70-471B-AA93-08E683A1B45",
  "ServerGroupId": "sgp-atstuj3rtoptyui****",
  "JobId": "72dcd26b-f12d-4c27-b3af-18f6aed5****"
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	IncorrectStatus.serverGroup	The status of servergroup [%s] is incorrect.	The current operation cannot be performed on the server group as its status is unavailable. Please check if the server group is currently undergoing any other operations.
400	Conflict.Lock	The Lock [%s] is conflict.	The specific resource is conflict.
400	IllegalParam.%s	The param of %s is illegal.
400	MissingParam.%s	The parameter of %s is missing.
403	Forbidden.%s	Authentication is failed for %s.
403	Forbidden.NoPermission	Authentication is failed for NoPermission.	Authentication is failed for NoPermission.
404	ResourceNotFound.BackendServer	The specified resource of BackendServer is not found.	The specified backend server resource was not found. Please check the input parameters.
404	ResourceNotFound.serverGroup	The specified resource of serverGroup is not found.	The specified resource of serverGroup is not found. Please check the input parameters.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.