Gunakan UpdateRulesAttribute untuk Mengelola Aturan Forwarding ALB - Server Load Balancer

Memperbarui properti beberapa aturan pengalihan secara batch.

Deskripsi operasi

UpdateRulesAttribute adalah operasi asinkron. Setelah Anda mengirim permintaan, sistem akan mengembalikan ID permintaan dan menjalankan tugas di latar belakang. Properti aturan pengalihan tidak diperbarui secara langsung. Anda dapat memanggil operasi ListRules untuk mengecek status pembaruan aturan pengalihan:

Jika beberapa aturan pengalihan berada dalam status Configuring, propertinya sedang diperbarui secara batch.
Jika beberapa aturan pengalihan berada dalam status Available, propertinya telah diperbarui.
Satu aturan pengalihan mendukung jumlah maksimum kondisi (RuleConditions) dan aksi (RuleActions) sebagai berikut:
- Kondisi: 5 untuk instans Edisi Dasar, 10 untuk instans Edisi Standar, dan 10 untuk instans yang diaktifkan WAF.
- Aksi: 3 untuk instans Edisi Dasar, 5 untuk instans Edisi Standar, dan 5 untuk instans yang diaktifkan WAF.

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:UpdateRulesAttribute

update

*LoadBalancer

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

*ServerGroup

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

None

Parameter permintaan

Parameter	Type	Required	Description	Example
ClientToken	string	No	Token klien yang digunakan untuk memastikan idempotensi permintaan. Pastikan token klien bersifat unik di antara permintaan yang berbeda. Token klien hanya boleh berisi karakter ASCII. Catatan Jika Anda tidak menentukan parameter ini, sistem secara otomatis menggunakan RequestId dari permintaan API sebagai ClientToken. RequestId setiap permintaan API berbeda-beda.	123e4567-e89b-12d3-a456-42665544***
Rules	array<object>	Yes	Daftar aturan pengalihan.
	array<object>	Yes	Sebuah aturan pengalihan.
Priority	integer	No	Prioritas aturan pengalihan.	80
RuleName	string	No	Nama aturan pengalihan.	rule_111
RuleActions	array<object>	No	Daftar aksi aturan pengalihan.
	array<object>	Yes	Sebuah aksi aturan pengalihan.
FixedResponseConfig	object	No	Konfigurasi aksi untuk mengembalikan respons tetap.
Content	string	No	Konten.	dssacav
ContentType	string	No	Tipe konten.	text/plain
HttpCode	string	No	Kode status HTTP.	200
ForwardGroupConfig	object	No	Konfigurasi aksi untuk meneruskan permintaan ke grup server.
ServerGroupTuples	array<object>	No	Daftar grup server tujuan.
	object	No	Sebuah grup server tujuan.
ServerGroupId	string	No	ID grup server.	sgp-3kbj35ay7cvi******
Weight	integer	No	Bobot.	100
ServerGroupStickySession	object	No	Persistensi sesi antar grup server.
Enabled	boolean	No	Menentukan apakah persistensi sesi diaktifkan.	true
Timeout	integer	No	Periode timeout.	100
InsertHeaderConfig	object	No	Konfigurasi aksi untuk menyisipkan header.
CoverEnabled	boolean	No	Menentukan apakah nilai header permintaan akan ditimpa.	False
Key	string	No	Header HTTP.	key
Value	string	No	Konten header HTTP.	value
ValueType	string	No	Tipe nilai.	SystemDefined
Order	integer	Yes	Prioritas.	1
RedirectConfig	object	No	Konfigurasi aksi pengalihan.
Host	string	No	Host tujuan tempat permintaan dialihkan.	test.alb.com
HttpCode	string	No	Metode pengalihan.	301
Path	string	No	Jalur tujuan tempat permintaan dialihkan.	/
Port	string	No	Port tujuan tempat permintaan dialihkan.	443
Protocol	string	No	Protokol tujuan tempat permintaan dialihkan.	HTTPS
Query	string	No	String kueri tujuan tempat permintaan dialihkan.	${query}
RewriteConfig	object	No	Konfigurasi aksi penulisan ulang.
Host	string	No	Hostname.	${host}
Path	string	No	Jalur.	/
Query	string	No	Kueri.	${query}
Type	string	Yes	Tipe aksi aturan pengalihan.	ForwardGroup
TrafficLimitConfig	object	No	Konfigurasi pembatasan kecepatan.
QPS	integer	No	Jumlah permintaan per detik (QPS).	1000
PerIpQps	integer	No	Jumlah QPS untuk satu alamat IP.	100
TrafficMirrorConfig	object	No	Konfigurasi pencerminan lalu lintas.
TargetType	string	No	Tipe tujuan pencerminan.	ForwardGroupMirror
MirrorGroupConfig	object	No	Grup server tempat lalu lintas dicerminkan.
ServerGroupTuples	array<object>	No	Grup server tempat lalu lintas dicerminkan.
	object	No	Grup server tempat lalu lintas dicerminkan.
ServerGroupId	string	No	ID grup server.	sgp-vlnjo1rhw0vc******
RemoveHeaderConfig	object	No	Konfigurasi untuk menghapus header HTTP tertentu.
Key	string	No	Kunci header HTTP.	key
CorsConfig	object	No	Konfigurasi Berbagi Sumber Daya Lintas Asal (CORS).
AllowOrigin	array	No	Asal yang diizinkan.
	string	No	Asal yang diizinkan.	*
AllowMethods	array	No	Metode HTTP yang diizinkan untuk permintaan lintas asal.
	string	No	Metode HTTP yang diizinkan untuk permintaan lintas asal. Nilai yang valid: GET POST PUT DELETE HEAD OPTIONS PATCH	GET
AllowHeaders	array	No	Daftar header yang diizinkan untuk permintaan lintas asal.
	string	No	Header yang diizinkan untuk permintaan lintas asal.	test
ExposeHeaders	array	No	Daftar header yang dapat diekspos ke klien.
	string	No	Header yang dapat diekspos ke klien.	test
AllowCredentials	string	No	Menentukan apakah kredensial diizinkan dalam permintaan lintas asal.	off
MaxAge	integer	No	Durasi cache maksimum permintaan preflight di browser.	60
RuleConditions	array<object>	No	Daftar kondisi aturan pengalihan.
	array<object>	Yes	Sebuah kondisi aturan pengalihan.
CookieConfig	object	No	Konfigurasi kondisi berbasis cookie.
Values	array<object>	No	Daftar pasangan kunci-nilai cookie.
	object	No	Pasangan kunci-nilai cookie.
Key	string	No	Kunci cookie.	key
Value	string	No	Nilai cookie.	value
HeaderConfig	object	No	Konfigurasi kondisi berbasis header.
Key	string	No	Kunci header HTTP.	key
Values	array	No	Daftar nilai header HTTP.
	string	No	Nilai header HTTP.	value
HostConfig	object	No	Konfigurasi kondisi berbasis host.
Values	array	No	Daftar hostname.
	string	No	Hostname.	www.example.com
MethodConfig	object	No	Konfigurasi kondisi berbasis metode.
Values	array	No	Daftar metode permintaan HTTP.
	string	No	Metode permintaan HTTP.	PUT
PathConfig	object	No	Konfigurasi kondisi berbasis jalur.
Values	array	No	Daftar kondisi jalur.
	string	No	Kondisi jalur.	/test
QueryStringConfig	object	No	Konfigurasi kondisi berbasis string kueri.
Values	array<object>	No	Daftar pasangan kunci-nilai string kueri.
	object	No	Pasangan kunci-nilai string kueri.
Key	string	No	Kunci string kueri.	account
Value	string	No	Nilai string kueri.	on
ResponseHeaderConfig	object	No	Konfigurasi kondisi berbasis header respons.
Key	string	No	Kunci header respons.	test
Values	array	No	Nilai header respons.
	string	No	Nilai header respons.	value
ResponseStatusCodeConfig	object	No	Konfigurasi kondisi berbasis kode status respons.
Values	array	No	Kode status respons.
	string	No	Kode status respons.	200
Type	string	No	Tipe kondisi.	Header
SourceIpConfig	object	No	Konfigurasi untuk mencocokkan lalu lintas layanan berdasarkan alamat IP sumber.
Values	array	No	Satu atau beberapa alamat IP atau blok CIDR.
	string	No	Alamat IP atau blok CIDR.	192.168.1.1
RuleId	string	Yes	ID aturan pengalihan.	rule-n4hfecmmtmfl******
DryRun	boolean	No	Menentukan apakah akan melakukan dry run. Nilai yang valid: true: melakukan dry run. Sistem memeriksa parameter yang diperlukan, format permintaan, dan batas layanan. Jika permintaan gagal dalam dry run, pesan kesalahan dikembalikan. Jika permintaan lolos dry run, kode kesalahan `DryRunOperation` dikembalikan. Dalam kasus ini, properti aturan pengalihan tidak diperbarui. false (default): mengirim permintaan normal. Setelah permintaan lolos pemeriksaan, sistem mengembalikan kode status `HTTP 2xx` dan memulai pembaruan.	false

Elemen respons

Element	Type	Description	Example
	object	Skema respons
RequestId	string	ID permintaan.	365F4154-92F6-4AE4-92F8-7FF34B540710
JobId	string	ID tugas asinkron.	72dcd26b-f12d-4c27-b3af-18f6aed5****

Contoh

Respons sukses

JSONformat

{
  "RequestId": "365F4154-92F6-4AE4-92F8-7FF34B540710",
  "JobId": "72dcd26b-f12d-4c27-b3af-18f6aed5****"
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	OperationDenied.IpGroupCanNotUsedForMirrorAction	The operation is not allowed because of %s.	The operation is not allowed because of %s.
400	IncorrectStatus.Rule	The status of %s [%s] is incorrect.
400	OperationDenied.SameGroupForForwardAndMirrorAction	The operation is not allowed because of %s.	The operation is not allowed because of %s.
400	OperationDenied.GRPCServerGroup	The operation is not allowed because of %s.
400	Conflict.Priority	There is already %s having the same configuration with %s.
400	ResourceQuotaExceeded.ServerGroupAttachedNum	The quota of %s is exceeded for resource %s, usage %s/%s.
400	ResourceQuotaExceeded.LoadBalancerServersNum	The quota of %s is exceeded for resource %s, usage %s/%s.
400	ResourceQuotaExceeded.ServerAddedNum	The quota of %s is exceeded for resource %s, usage %s/%s.
400	QuotaExceeded.RuleWildcardsNum	The quota of %s is exceeded, usage %s/%s.	The quota of %s is exceeded, usage %s/%s.
400	QuotaExceeded.RuleMatchEvaluationsNum	The quota of %s is exceeded, usage %s/%s.
400	QuotaExceeded.RuleActionsNum	The quota of %s is exceeded, usage %s/%s.	The quota of %s is exceeded. Usage: %s/%s.
400	Mismatch.Protocol	The %s is mismatched for %s and %s.	The %s is mismatched for %s and %s.
400	Mismatch.VpcId	The %s is mismatched for %s and %s.	The %s is mismatched for %s and %s.
400	OperationDenied.ServiceManagedResource	The operation is not allowed because the current resource of %s is managed resource.
400	OperationDenied.ListenerIdInconsistent	The operation is not allowed because of ListenerIdInconsistent.
400	IllegalParam.Priority	The param of Priority is illegal.
400	OperationDenied.MirrorActionSupportHttpGroupOnly	The operation is not allowed because of MirrorActionSupportHttpGroupOnly.
400	OperationDenied.ProtocolMustSameForForwardGroupAction	The operation is not allowed because of ProtocolMustSameForForwardGroupAction.
404	ResourceNotFound.Rule	The specified resource %s is not found.	The specified resource %s is not found.
404	ResourceNotFound.ServerGroup	The specified resource %s is not found.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.