All Products
Search
Document Center

Server Load Balancer:UpdateRuleAttribute

Last Updated:Dec 19, 2025

Memperbarui properti aturan pengalihan, seperti kondisi, aksi, dan nama aturan tersebut.

Deskripsi operasi

  • UpdateRuleAttribute adalah operasi asinkron. Setelah mengirim permintaan, sistem akan mengembalikan ID permintaan dan menjalankan tugas di latar belakang. Anda dapat memanggil operasi ListRules untuk mengecek status aturan pengalihan.

    • Jika aturan pengalihan berada dalam status Configuring, propertinya sedang diperbarui.

    • Jika aturan pengalihan berada dalam status Available, propertinya telah diperbarui.

  • Jumlah maksimum kondisi (RuleConditions) dan aksi (RuleActions) yang dapat ditambahkan ke aturan pengalihan adalah sebagai berikut:

    • Kondisi: 5 untuk Edisi Dasar, 10 untuk Edisi Standar, dan 10 untuk Edisi dengan WAF.

    • Aksi: 3 untuk Edisi Dasar, 5 untuk Edisi Standar, dan 5 untuk Edisi dengan 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:UpdateRuleAttribute

update

*LoadBalancer

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

*ServerGroup

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

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

RuleId

string

Yes

ID aturan pengalihan.

rule-4dp5i6ea****

ClientToken

string

No

Token klien yang digunakan untuk memastikan idempotensi permintaan.

Buat nilai parameter dari klien Anda untuk memastikan nilainya 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 mungkin berbeda untuk setiap permintaan API.

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

DryRun

boolean

No

Menentukan apakah akan melakukan dry run. Nilai yang valid:

  • true: Melakukan dry run tetapi tidak memperbarui properti aturan pengalihan. Sistem memeriksa permintaan terhadap parameter yang diperlukan, format permintaan, dan batas layanan. Jika permintaan gagal dalam dry run, kode kesalahan dikembalikan. Jika permintaan lolos dry run, kode kesalahan DryRunOperation dikembalikan.

  • false (default): Mengirim permintaan. Jika permintaan lolos pemeriksaan, kode status HTTP 2xx dikembalikan dan operasi dilakukan.

false

RuleConditions

array<object>

No

Kondisi aturan pengalihan.

array<object>

No

Kondisi aturan pengalihan.

CookieConfig

object

No

Konfigurasi cookie.

Values

array<object>

No

Cookie.

object

No

Konfigurasi cookie.

Key

string

No

Kunci cookie. Kunci harus terdiri dari 1 hingga 100 karakter dan dapat berisi huruf kecil, karakter yang dapat dicetak, tanda bintang (*), dan tanda tanya (?). Kunci tidak boleh berisi spasi atau karakter khusus berikut: #[]{}\|<>&";.

test

Value

string

No

Nilai cookie. Nilai harus terdiri dari 1 hingga 128 karakter dan dapat berisi huruf kecil, karakter yang dapat dicetak, tanda bintang (*), dan tanda tanya (?). Nilai tidak boleh berisi spasi atau karakter khusus berikut: #[]{}\|<>&.

test

HeaderConfig

object

No

Konfigurasi header permintaan.

Key

string

No

Kunci header permintaan. Kunci harus terdiri dari 1 hingga 40 karakter dan dapat berisi huruf, angka, tanda hubung (-), dan garis bawah (_). Cookie dan Host tidak didukung.

Port

Values

array

No

Nilai header permintaan.

string

No

Nilai header permintaan. Nilai-nilai untuk kunci header permintaan yang sama tidak boleh identik dalam satu kondisi aturan pengalihan. Konvensi penamaan:

  • Nilai harus terdiri dari 1 hingga 128 karakter.

  • Nilai dapat berisi karakter yang dapat dicetak dengan nilai ASCII dari 32 hingga 126, tanda bintang (*), dan tanda tanya (?). Nilai tidak boleh berisi tanda kutip ganda (").

  • Nilai tidak boleh diawali atau diakhiri dengan spasi. Nilai tidak boleh diakhiri dengan garis miring terbalik (\).

5006

HostConfig

object

No

Konfigurasi host.

Values

array

No

Daftar hostname.

string

No

Hostname. Konvensi penamaan:

  • Hostname harus terdiri dari 3 hingga 128 karakter dan dapat berisi huruf kecil, angka, tanda hubung (-), titik (.), tanda bintang (*), dan tanda tanya (?).

  • Hostname harus berisi setidaknya satu titik (.). Titik tidak boleh menjadi karakter pertama atau terakhir.

  • Label domain paling kanan hanya boleh berisi huruf, tanda bintang (*), dan tanda tanya (?). Label tersebut tidak boleh berisi angka atau tanda hubung (-).

  • Tanda hubung (-) tidak boleh menjadi karakter pertama atau terakhir dalam label domain. Tanda bintang (*) dan tanda tanya (?) dapat digunakan di posisi mana pun dalam label domain.

www.example.com

MethodConfig

object

No

Konfigurasi metode permintaan.

Values

array

No

Daftar metode permintaan.

string

No

Metode permintaan.

Nilai yang valid: HEAD, GET, POST, OPTIONS, PUT, PATCH, dan DELETE.

PUT

PathConfig

object

No

Konfigurasi path.

Values

array

No

Daftar path pengalihan.

string

No

Path pengalihan. Konvensi penamaan:

  • Path harus terdiri dari 1 hingga 128 karakter.

  • Path harus diawali dengan garis miring (/). Path dapat berisi huruf, angka, dan karakter khusus berikut: $-_.+/&~@:. Path tidak boleh berisi karakter khusus berikut: “%#;!()[]^,”\". Tanda bintang (*) dan tanda tanya (?) dapat digunakan sebagai karakter wildcard.

/test

QueryStringConfig

object

No

Konfigurasi string kueri.

Values

array<object>

No

Daftar string kueri. Anda dapat menambahkan hingga 20 string kueri.

object

No

Struktur string kueri.

Key

string

No

Kunci string kueri. Kunci harus terdiri dari 1 hingga 100 karakter dan dapat berisi huruf kecil, karakter yang dapat dicetak, tanda bintang (*), dan tanda tanya (?). Kunci tidak boleh berisi spasi atau karakter khusus berikut: #[]{}\|<>&".

test

Value

string

No

Nilai string kueri. Nilai harus terdiri dari 1 hingga 128 karakter dan dapat berisi huruf kecil, karakter yang dapat dicetak, tanda bintang (*), dan tanda tanya (?). Nilai tidak boleh berisi spasi atau karakter khusus berikut: #[]{}\|<>&".

test

Type

string

No

Jenis kondisi aturan pengalihan. Anda dapat menambahkan hingga tujuh jenis kondisi aturan pengalihan. Nilai yang valid:

  • Host: host.

  • Path: path.

  • Header: Header HTTP.

  • QueryString: string kueri.

  • Method: metode permintaan.

  • Cookie: cookie.

  • SourceIp: alamat IP sumber.

  • ResponseHeader: header respons HTTP.

  • ResponseStatusCode: kode status respons.

Host

ResponseStatusCodeConfig

object

No

Konfigurasi kode status HTTP.

Values

array

No

Daftar kode status HTTP.

string

No

Kode status HTTP.

301

ResponseHeaderConfig

object

No

Konfigurasi kondisi header.

Key

string

No

Kunci header.

  • Kunci harus terdiri dari 1 hingga 40 karakter.

  • Kunci dapat berisi huruf, angka, tanda hubung (-), dan garis bawah (_).

  • Cookie dan Host tidak didukung.

test

Values

array

No

Nilai header.

string

No

Nilai header.

  • Nilai harus terdiri dari 1 hingga 128 karakter.

  • Nilai dapat berisi karakter yang dapat dicetak dengan nilai ASCII dari 32 hingga 126, huruf kecil, tanda bintang (*), dan tanda tanya (?). Nilai tidak boleh berisi tanda kutip ganda (").

  • Nilai tidak boleh diawali atau diakhiri dengan spasi. Nilai tidak boleh diakhiri dengan garis miring terbalik (\).

50006

SourceIpConfig

object

No

Mencocokkan lalu lintas layanan berdasarkan alamat IP sumber. Anda dapat menambahkan hingga lima alamat IP sumber.

Values

array

No

Satu atau beberapa alamat IP atau Blok CIDR.

string

No

Satu atau beberapa alamat IP atau Blok CIDR.

192.168.0.0/32

RuleActions

array<object>

No

Aksi aturan pengalihan.

array<object>

No

Aksi aturan pengalihan.

FixedResponseConfig

object

No

Konfigurasi respons tetap.

Content

string

No

Respons tetap. Respons dapat memiliki panjang hingga 1 KB dan hanya boleh berisi karakter ASCII.

dssacav

ContentType

string

No

Format respons tetap.

Nilai yang valid: text/plain, text/css, text/html, application/javascript, dan application/json.

text/plain

HttpCode

string

No

Kode status HTTP. Nilai harus berupa string yang terdiri dari angka. Nilai yang valid: 2xx, 4xx, dan 5xx. x adalah angka.

200

ForwardGroupConfig

object

No

Konfigurasi kelompok server.

ServerGroupTuples

array<object>

No

Daftar kelompok server tujuan.

object

No

Kelompok server tujuan.

ServerGroupId

string

No

ID kelompok server tujuan.

sg--atstuj3rtoptyui****

Weight

integer

No

Bobot. Nilai yang lebih besar menunjukkan bobot yang lebih tinggi. Kelompok server dengan bobot lebih tinggi menerima lebih banyak permintaan. Nilai yang valid: 0 hingga 100.

  • Jika jumlah kelompok server tujuan adalah 1, nilai default adalah 100 jika Anda tidak menentukan bobot.

  • Jika jumlah kelompok server tujuan lebih dari 1, Anda harus menentukan bobot.

30

ServerGroupStickySession

object

No

Persistensi sesi untuk kelompok server.

Enabled

boolean

No

Menentukan apakah persistensi sesi diaktifkan. Nilai yang valid:

  • true: mengaktifkan persistensi sesi.

  • false (default): menonaktifkan persistensi sesi.

false

Timeout

integer

No

Periode timeout. Satuan: detik. Nilai yang valid: 1 hingga 86400.

2

InsertHeaderConfig

object

No

Konfigurasi untuk menyisipkan header permintaan.

CoverEnabled

boolean

No

Menentukan apakah akan menimpa nilai header permintaan yang memiliki kunci yang sama. Nilai yang valid:

  • true: ya.

  • false (default): tidak.

false

Key

string

No

Kunci header permintaan yang akan disisipkan. Kunci harus terdiri dari 1 hingga 40 karakter, dan dapat berisi huruf kecil, angka, garis bawah (_), dan tanda hubung (-). Kunci dalam InsertHeaderConfig tidak boleh sama dengan kunci dalam RemoveHeaderConfig.

Catatan

Kunci header berikut tidak didukung: slb-id, slb-ip, x-forwarded-for, x-forwarded-proto, x-forwarded-eip, x-forwarded-port, x-forwarded-client-srcport, x-forwarded-host, connection, upgrade, content-length, transfer-encoding, keep-alive, te, host, cookie, remoteip, dan authority. Kunci tidak peka terhadap huruf besar/kecil.

key

Value

string

No

Nilai header yang akan disisipkan.

  • Jika ValueType diatur ke SystemDefined, Anda dapat mengatur nilai ke:

    • ClientSrcPort: port klien.

    • ClientSrcIp: alamat IP klien.

    • Protocol: protokol permintaan klien (HTTP atau HTTPS).

    • SLBId: ID instans Application Load Balancer.

    • SLBPort: port pendengar instans Application Load Balancer.

  • Jika ValueType diatur ke UserDefined, Anda dapat menentukan nilai header kustom. Nilai harus terdiri dari 1 hingga 128 karakter, dan dapat berisi tanda bintang (*), tanda tanya (?), serta karakter yang dapat dicetak dengan nilai ASCII dari 32 hingga 126. Nilai tidak boleh berisi tanda kutip ganda ("). Nilai tidak boleh diawali atau diakhiri dengan spasi. Nilai tidak boleh diakhiri dengan garis miring terbalik (\).

  • Jika ValueType diatur ke ReferenceHeader, Anda dapat mereferensikan header permintaan. Nilai harus terdiri dari 1 hingga 128 karakter, dan dapat berisi huruf kecil, angka, tanda hubung (-), dan garis bawah (_).

UserDefined

ValueType

string

No

Jenis nilai header. Nilai yang valid:

  • UserDefined: nilai header kustom.

  • ReferenceHeader: nilai header yang direferensikan dari header permintaan.

  • SystemDefined: nilai header yang ditentukan sistem.

UserDefined

Order

integer

No

Urutan aksi. Nilai yang valid: 1 hingga 50000. Nilai yang lebih kecil menunjukkan prioritas yang lebih tinggi. Nilai harus unik dan tidak boleh kosong. Anda dapat menentukan hingga 20 urutan untuk aksi.

1

RedirectConfig

object

No

Konfigurasi pengalihan. Anda dapat menambahkan hingga 20 pengalihan.

Host

string

No

Hostname tujuan. Nilai yang valid:

  • ${host} (default): Anda tidak dapat menggunakan nilai ini bersama karakter lain.

  • Nilai lain harus memenuhi persyaratan berikut:

    • Hostname harus terdiri dari 3 hingga 128 karakter dan dapat berisi huruf kecil, angka, tanda hubung (-), titik (.), tanda bintang (*), dan tanda tanya (?).

    • Hostname harus berisi setidaknya satu titik (.). Titik tidak boleh menjadi karakter pertama atau terakhir.

    • Label domain paling kanan hanya boleh berisi huruf dan karakter wildcard. Label tersebut tidak boleh berisi angka atau tanda hubung (-).

    • Tanda hubung (-) tidak boleh menjadi karakter pertama atau terakhir dalam label domain.

    • Tanda bintang (*) dan tanda tanya (?) dapat digunakan di posisi mana pun dalam label domain.

www.example.com

HttpCode

string

No

Metode pengalihan. Nilai yang valid: 301, 302, 303, 307, dan 308.

301

Path

string

No

Path tujuan. Nilai yang valid:

  • ${path} (default): Anda dapat mereferensikan ${host}, ${protocol}, dan ${port}. Setiap variabel hanya dapat direferensikan sekali. Anda dapat menggunakan variabel ini bersama-sama atau menggabungkannya dengan string yang memenuhi persyaratan berikut.

  • Nilai lain harus memenuhi persyaratan berikut:

    • Path harus terdiri dari 1 hingga 128 karakter.

    • Path harus diawali dengan garis miring (/). Path dapat berisi huruf, angka, dan karakter khusus berikut: $-_.+/&~@:. Path tidak boleh berisi karakter khusus berikut: “%#;!()[]^,”\". Tanda bintang (*) dan tanda tanya (?) dapat digunakan sebagai karakter wildcard.

/test

Port

string

No

Port tujuan. Nilai yang valid:

  • ${port} (default): Anda hanya dapat menggunakan nilai ini. Anda tidak dapat menggunakan nilai ini bersama karakter lain.

  • Nilai lain: 1 hingga 63335.

10

Protocol

string

No

Protokol tujuan. Nilai yang valid:

  • ${protocol} (default): Anda tidak dapat menggunakan nilai ini bersama karakter lain.

  • HTTP atau HTTPS.

Catatan

Pendengar HTTPS hanya mendukung HTTPS.

HTTP

Query

string

No

String kueri tujuan. Nilai yang valid:

  • ${query} (default): Anda dapat mereferensikan ${host}, ${protocol}, dan ${port}. Setiap variabel hanya dapat direferensikan sekali. Anda dapat menggunakan variabel ini bersama-sama atau menggabungkannya dengan string yang memenuhi persyaratan berikut.

  • Nilai lain harus memenuhi persyaratan berikut:

    • Nilai harus terdiri dari 1 hingga 128 karakter.

    • Nilai dapat berisi karakter yang dapat dicetak tetapi tidak boleh berisi spasi atau karakter khusus berikut: #[]{}\|<>". Jika nilai berisi huruf, huruf tersebut harus huruf kecil.

quert

RewriteConfig

object

No

Konfigurasi rewrite.

Host

string

No

Hostname tujuan untuk pengalihan internal. Nilai yang valid:

  • ${host} (default): Anda tidak dapat menggunakan nilai ini bersama karakter lain.

  • Nilai lain harus memenuhi persyaratan berikut:

    • Hostname harus terdiri dari 3 hingga 128 karakter dan dapat berisi huruf kecil, angka, tanda hubung (-), titik (.), tanda bintang (*), dan tanda tanya (?).

    • Hostname harus berisi setidaknya satu titik (.). Titik tidak boleh menjadi karakter pertama atau terakhir.

    • Label domain paling kanan hanya boleh berisi huruf dan karakter wildcard. Label tersebut tidak boleh berisi angka atau tanda hubung (-).

    • Tanda hubung (-) tidak boleh menjadi karakter pertama atau terakhir dalam label domain. Tanda bintang (*) dan tanda tanya (?) dapat digunakan di posisi mana pun dalam label domain.

www.example.com

Path

string

No

Path tujuan. Nilai yang valid:

  • ${path} (default): Anda dapat mereferensikan ${host}, ${protocol}, dan ${port}. Setiap variabel hanya dapat direferensikan sekali. Anda dapat menggunakan variabel ini bersama-sama atau menggabungkannya dengan string yang memenuhi persyaratan berikut.

  • Nilai lain harus memenuhi persyaratan berikut:

    • Path harus terdiri dari 1 hingga 128 karakter.

    • Path harus diawali dengan garis miring (/). Path dapat berisi huruf, angka, dan karakter khusus berikut: $-_.+/&~@:. Path tidak boleh berisi karakter khusus berikut: “%#;!()[]^,”\". Tanda bintang (*) dan tanda tanya (?) dapat digunakan sebagai karakter wildcard.

/tsdf

Query

string

No

String kueri tujuan untuk pengalihan internal. Nilai yang valid:

  • ${query} (default): Anda dapat mereferensikan ${host}, ${protocol}, dan ${port}. Setiap variabel hanya dapat direferensikan sekali. Anda dapat menggunakan variabel ini bersama-sama atau menggabungkannya dengan string yang memenuhi persyaratan berikut.

  • Nilai lain harus memenuhi persyaratan berikut:

    • Nilai harus terdiri dari 1 hingga 128 karakter.

    • Nilai dapat berisi karakter yang dapat dicetak tetapi tidak boleh berisi spasi atau karakter khusus berikut: #[]{}\|<>". Jika nilai berisi huruf, huruf tersebut harus huruf kecil.

quedsa

Type

string

No

Jenis aksi. Anda dapat menambahkan hingga 11 jenis aksi. Nilai yang valid:

  • ForwardGroup: meneruskan permintaan ke beberapa kelompok vServer.

  • Redirect: mengalihkan permintaan.

  • FixedResponse: mengembalikan respons tetap.

  • Rewrite: menulis ulang permintaan.

  • InsertHeader: menyisipkan header.

  • RemoveHeader: menghapus header.

  • TrafficLimit: membatasi kecepatan trafik.

  • TrafficMirror: mencerminkan trafik.

  • Cors: mengaktifkan Berbagi Sumber Daya Lintas Asal (CORS).

Catatan

Aturan pengalihan harus berisi aksi ForwardGroup, Redirect, atau FixedResponse. Jika Anda ingin menggunakan aksi ini bersama jenis aksi lain, pastikan aksi ini dieksekusi terakhir.

ForwardGroup

TrafficLimitConfig

object

No

Konfigurasi pembatasan kecepatan.

QPS

integer

No

Jumlah permintaan per detik (QPS). Nilai yang valid: 1 hingga 1000000.

100

PerIpQps

integer

No

QPS untuk satu alamat IP. Nilai yang valid: 1 hingga 1000000.

Catatan

Jika Anda menentukan QPS dan PerIpQps, nilai PerIpQps harus lebih kecil dari nilai QPS.

80

TrafficMirrorConfig

object

No

Konfigurasi pencerminan lalu lintas.

TargetType

string

No

Jenis tujuan tempat lalu lintas dicerminkan. Nilai yang valid:

  • ForwardGroupMirror: kelompok server.

ForwardGroupMirror

MirrorGroupConfig

object

No

Kelompok server tempat lalu lintas dicerminkan.

ServerGroupTuples

array<object>

No

Kelompok server tempat lalu lintas dicerminkan.

object

No

Kelompok server tempat lalu lintas dicerminkan.

ServerGroupId

string

No

ID kelompok server.

srg-00mkgijak0w4qgz9****

RemoveHeaderConfig

object

No

Konfigurasi untuk menghapus header permintaan.

Key

string

No

Kunci header permintaan yang akan dihapus. Kunci harus terdiri dari 1 hingga 40 karakter, dan dapat berisi huruf kecil, angka, garis bawah (_), dan tanda hubung (-). Kunci tidak boleh digunakan lebih dari sekali dalam RemoveHeaderConfig.

  • Jika Direction diatur ke Request, kunci header berikut tidak didukung: slb-id, slb-ip, x-forwarded-for, x-forwarded-proto, x-forwarded-eip, x-forwarded-port, x-forwarded-client-srcport, x-forwarded-host, connection, upgrade, content-length, transfer-encoding, keep-alive, te, host, cookie, remoteip, dan authority. Kunci tidak peka terhadap huruf besar/kecil.

  • Jika Direction diatur ke Response, kunci header berikut tidak didukung: connection, upgrade, content-length, dan transfer-encoding. Kunci tidak peka terhadap huruf besar/kecil.

test

CorsConfig

object

No

Konfigurasi CORS.

AllowOrigin

array

No

Daftar origin yang diizinkan. Anda hanya dapat menentukan satu * atau menentukan satu atau beberapa nilai.

  • Nilai harus diawali dengan http:// atau https://, diikuti oleh nama domain yang valid atau nama domain wildcard tingkat atas. Contoh: http://*.test.abc.example.com.

  • Anda dapat menentukan port. Port harus berupa bilangan bulat dari 1 hingga 65535.

string

No

Origin yang diizinkan.

http://test.com

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

Daftar header yang diizinkan untuk permintaan lintas asal. Anda dapat menentukan * atau menentukan satu atau beberapa nilai. Pisahkan beberapa nilai dengan koma (,). Nilai dapat berisi huruf, angka, garis bawah (_), dan tanda hubung (-). Garis bawah atau tanda hubung tidak boleh menjadi karakter pertama atau terakhir. Nilai dapat terdiri dari hingga 32 karakter.

test_123

ExposeHeaders

array

No

Daftar header yang dapat diekspos ke klien.

string

No

Daftar header yang dapat diekspos ke klien. Anda dapat menentukan * atau menentukan satu atau beberapa nilai. Pisahkan beberapa nilai dengan koma (,). Nilai dapat berisi huruf, angka, garis bawah (_), dan tanda hubung (-). Garis bawah atau tanda hubung tidak boleh menjadi karakter pertama atau terakhir. Nilai dapat terdiri dari hingga 32 karakter.

test_123

AllowCredentials

string

No

Menentukan apakah kredensial diizinkan. Nilai yang valid:

  • on: ya.

  • off: tidak.

on

MaxAge

integer

No

Waktu cache maksimum untuk permintaan preflight di browser. Satuan: detik.

Nilai yang valid: -1 hingga 172800.

1000

RuleName

string

No

Nama aturan pengalihan. Nama harus terdiri dari 2 hingga 128 karakter, dan dapat berisi huruf, angka, titik (.), garis bawah (_), dan tanda hubung (-). Nama harus diawali dengan huruf atau karakter Tionghoa.

rule-instance-test

Priority

integer

No

Prioritas aturan. Nilai yang valid: 1 hingga 10000. Nilai yang lebih kecil menunjukkan prioritas yang lebih tinggi.

Catatan

Prioritas aturan yang dimiliki oleh pendengar yang sama harus unik.

10

Elemen respons

Element

Type

Description

Example

object

Memperbarui atribut aturan pengalihan yang ditentukan.

JobId

string

ID tugas asinkron.

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

RequestId

string

ID permintaan.

365F5378-41F6-4AE4-92F8-7FF34B540710

Contoh

Respons sukses

JSONformat

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

Kode kesalahan

HTTP status code

Error code

Error message

Description

400 IncorrectStatus.Rule The status of %s [%s] is incorrect.
400 OperationDenied.IpGroupCanNotUsedForMirrorAction The operation is not allowed because of %s. The operation is not allowed because of %s.
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.RewriteMissingForwardGroup The operation is not allowed because of RewriteMissingForwardGroup. The operation is not allowed because rewrite is missing the forward group.
400 ResourceInConfiguring.Listener The specified listener is being configured, please try again later.
400 OperationDenied.ProtocolMustSameForForwardGroupAction The operation is not allowed because of ProtocolMustSameForForwardGroupAction.
403 Forbidden.ServerGroup Authentication has failed for ServerGroup.
403 Forbidden.LoadBalancer Authentication is failed for %s. Authentication is failed for %s.
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.