All Products
Search

This Product

    Server Load Balancer:UpdateRuleAttribute

    Document Center

    Server Load Balancer:UpdateRuleAttribute

    Last Updated:Jul 15, 2026

    Memperbarui atribut aturan pengalihan, seperti kondisi, aksi, dan nama.

    Deskripsi operasi

    • UpdateRuleAttribute adalah operasi asinkron. Setelah permintaan dikirim, sistem mengembalikan ID permintaan. Namun, atribut aturan pengalihan belum diperbarui. Tugas pembaruan terus berjalan di latar belakang. Anda dapat memanggil ListRules untuk mengkueri status pembaruan atribut aturan pengalihan:

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

      • Jika atribut aturan pengalihan berada dalam status Available, atribut 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 Jenis Penyimpanan Standar, dan 10 untuk Edisi dengan WAF diaktifkan.

      • Aksi: 3 untuk Edisi Dasar, 5 untuk Jenis Penyimpanan Standar, dan 5 untuk Edisi dengan WAF diaktifkan.

    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.

    Anda dapat menggunakan klien untuk menghasilkan token, tetapi Anda harus memastikan bahwa token tersebut unik di antara berbagai permintaan. Token hanya dapat berisi karakter ASCII.

    Catatan

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

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

    boolean

    No

    Apakah akan menjalankan dry run saja, tanpa menjalankan permintaan aktual. Nilai valid:

    • true: Hanya menjalankan dry run. Sistem memeriksa permintaan untuk potensi masalah, termasuk nilai parameter yang hilang, sintaks permintaan yang salah, dan batas layanan. Jika permintaan gagal dalam dry run, kode kesalahan dikembalikan. Jika permintaan lulus dry run, kode error DryRunOperation dikembalikan.

    • false (default): Menjalankan dry run dan menjalankan permintaan aktual. Jika permintaan lulus dry run, kode status HTTP 2xx dikembalikan dan operasi dijalankan.

    false
    RuleConditions

    array<object>

    No

    Kondisi aturan pengalihan.

    array<object>

    No

    Kondisi aturan pengalihan.

    CookieConfig

    object

    No

    Konfigurasi cookie.

    Values

    array<object>

    No

    Konfigurasi cookie.

    object

    No

    Konfigurasi cookie.

    Key

    string

    No

    The cookie key. The key must be 1 to 100 characters in length and can contain lowercase letters, printable characters, asterisks (*), and question marks (?). The key cannot contain spaces or the following special characters: #[]{}\|<>&";.

    test
    Value

    string

    No

    The cookie value. The value must be 1 to 128 characters in length and can contain lowercase letters, printable characters, asterisks (*), and question marks (?). The value cannot contain spaces or the following special characters: #[]{}\|<>&.

    test
    HeaderConfig

    object

    No

    Konfigurasi header.

    Key

    string

    No

    Kunci header. Panjang kunci harus 1 hingga 40 karakter dan dapat berisi huruf, digit, tanda hubung (-), dan garis bawah (_). Cookie dan Host tidak didukung.

    Port
    Values

    array

    No

    Nilai header.

    string

    No

    Nilai header. Nilai header dalam satu kondisi aturan pengalihan tidak boleh duplikat. Aturan penamaan:

    • Panjang nilai harus 1 hingga 128 karakter.

    • Nilai dapat berisi karakter yang dapat dicetak dengan nilai ASCII ch >= 32 && ch < 127, asterisk (*), dan tanda tanya (?). Nilai tidak boleh berisi ".

    • Nilai tidak boleh dimulai atau diakhiri dengan spasi. Nilai tidak boleh diakhiri dengan \.

    5006
    HostConfig

    object

    No

    Konfigurasi host.

    Values

    array

    No

    Hostname.

    string

    No

    Hostname. Aturan penamaan:

    • Panjang hostname harus 3 hingga 256 karakter dan dapat berisi huruf kecil a hingga z, digit, tanda hubung (-), titik (.), asterisk (*), dan tanda tanya (?).

    • Hostname harus mengandung setidaknya satu titik (.). Titik (.) tidak boleh muncul di awal atau akhir.

    • Label domain paling kanan hanya dapat berisi huruf, asterisk (*), dan tanda tanya (?). Label ini tidak boleh berisi digit atau tanda hubung (-).

    • Tanda hubung (-) tidak boleh muncul di awal atau akhir label domain lainnya. Asterisk (*) dan tanda tanya (?) dapat muncul di posisi mana pun dalam label domain.

    www.example.com
    MethodConfig

    object

    No

    Konfigurasi metode permintaan.

    Values

    array

    No

    Metode permintaan.

    string

    No

    Metode permintaan.

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

    PUT
    PathConfig

    object

    No

    Konfigurasi path untuk pengalihan.

    Values

    array

    No

    Path pengalihan.

    string

    No

    Path pengalihan. Aturan penamaan:

    • Panjang path harus 1 hingga 256 karakter.

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

    /test
    QueryStringConfig

    object

    No

    Konfigurasi kueri string.

    Values

    array<object>

    No

    Kueri string. Anda dapat menambahkan hingga 20 kueri string.

    object

    No

    Struktur kueri string.

    Key

    string

    No

    The key of the query string. The key must be 1 to 100 characters in length and can contain lowercase letters, printable characters, asterisks (*), and question marks (?). The key cannot contain spaces or the following special characters: #[]{}\|<>&".

    test
    Value

    string

    No

    The value of the query string. The value must be 1 to 128 characters in length and can contain lowercase letters, printable characters, asterisks (*), and question marks (?). The value cannot contain spaces or the following special characters: #[]{}\|<>&".

    test
    Type

    string

    No

    Tipe aturan pengalihan. Anda dapat menambahkan hingga 7 tipe aturan pengalihan. Nilai valid:

    • Host: host.

    • Path: path.

    • Header: bidang header HTTP.

    • QueryString: kueri string.

    • Method: metode permintaan.

    • Cookie: cookie.

    • SourceIp: alamat IP sumber.

    • ResponseHeader: bidang header tanggapan HTTP.

    • ResponseStatusCode: kode status tanggapan.

    Host
    ResponseStatusCodeConfig

    object

    No

    Konfigurasi kode status tanggapan.

    Values

    array

    No

    Daftar kode status tanggapan.

    string

    No

    Kode status tanggapan.

    301
    ResponseHeaderConfig

    object

    No

    Konfigurasi kondisi header respons.

    Key

    string

    No

    Kunci Port.

    • Panjang kunci harus 1 hingga 40 karakter.

    • Kunci dapat berisi huruf a hingga z, digit, tanda hubung (-), dan garis bawah (_).

    • Cookie dan Host tidak didukung.

    test
    Values

    array

    No

    Nilai header.

    string

    No

    Nilai header.

    • Panjang nilai harus 1 hingga 128 karakter.

    • Nilai dapat berisi karakter yang dapat dicetak dengan nilai ASCII ch >= 32 && ch < 127, huruf kecil, serta wildcard asterisk (*) dan tanda tanya (?). Nilai tidak boleh berisi ".

    • Nilai tidak boleh dimulai atau diakhiri dengan spasi. Nilai tidak boleh diakhiri dengan \.

    50006
    SourceIpConfig

    object

    No

    Konfigurasi pencocokan lalu lintas layanan-IP sumber. Anda dapat menambahkan hingga 5 kondisi pencocokan lalu lintas layanan-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 tanggapan tetap.

    Content

    string

    No

    Konten tetap yang akan dikembalikan. Ukuran konten maksimal 1 KB dan hanya dapat berisi karakter ASCII.

    dssacav
    ContentType

    string

    No

    Format konten tetap yang akan dikembalikan.

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

    text/plain
    HttpCode

    string

    No

    Kode tanggapan Port yang akan dikembalikan. Hanya string numerik dalam format 2xx, 4xx, dan 5xx yang didukung, di mana x adalah digit apa pun.

    200
    ForwardGroupConfig

    object

    No

    Konfigurasi kelompok penerusan.

    ServerGroupTuples

    array<object>

    No

    Kelompok server tujuan tempat permintaan diteruskan.

    object

    No

    Struktur kelompok server tujuan.

    ServerGroupId

    string

    No

    The ID of the destination server group.

    sg--atstuj3rtoptyui****
    Weight

    integer

    No

    The weight of the server group. A larger value indicates a higher weight. This means that the server group receives more requests. Valid values: 0 to 100.

    • If only one destination server group is specified, the weight is 100 by default.

    • If multiple destination server groups are specified, you must specify a weight for each server group.

    30
    ServerGroupStickySession

    object

    No

    Konfigurasi persistensi sesi antar kelompok server.

    Enabled

    boolean

    No

    Specifies whether to enable session persistence. Valid values:

    • true

    • false (default)

    false
    Timeout

    integer

    No

    The timeout period, in seconds. Valid values: 1 to 86400.

    2
    InsertHeaderConfig

    object

    No

    Konfigurasi sisipkan header.

    CoverEnabled

    boolean

    No

    Apakah akan menimpa nilai dalam permintaan. Nilai valid:

    • true: Menimpa nilai.

    • false (default): Tidak menimpa nilai.

    false
    Key

    string

    No

    Nama header yang akan disisipkan. Panjang nama harus 1 hingga 40 karakter dan dapat berisi huruf besar dan kecil a hingga z, digit, garis bawah (_), dan tanda hubung (-). Nama header yang ditentukan dalam InsertHeaderConfig harus unik.

    Catatan

    Nama header tidak boleh diatur ke bidang berikut (tidak peka huruf besar/kecil): slb-id, slb-ip, x-forwarded-for, x-forwarded-proto, x-forwarded-eip, x-forwarded-port, x-forwarded-client-srcport, x-forwarded-host, connection, Peningkatan, content-length, transfer-encoding, keep-alive, te, host, cookie, remoteip, authority.

    key
    Value

    string

    No

    Konten header yang akan disisipkan.

    • Jika ValueType diatur ke SystemDefined, nilai valid adalah:

      • ClientSrcPort: Port Klien.

      • ClientSrcIp: alamat IP Klien.

      • Protocol: protokol yang digunakan oleh permintaan Klien (HTTP atau HTTPS).

      • SLBId: ID instans Application Load Balancer (ALB).

      • SLBPort: Port Pendengar instans Application Load Balancer (ALB).

    • Jika ValueType diatur ke UserDefined: Anda dapat menentukan nilai header kustom. Panjang nilai harus 1 hingga 128 karakter dan dapat berisi wildcard asterisk (*), tanda tanya (?), serta karakter yang dapat dicetak dengan nilai ASCII ch >= 32 && ch < 127. Nilai tidak boleh berisi ". Nilai tidak boleh dimulai atau diakhiri dengan spasi. Nilai tidak boleh diakhiri dengan \.

    • Jika ValueType diatur ke ReferenceHeader: Anda dapat mereferensikan bidang dalam header permintaan. Panjang nilai harus 1 hingga 128 karakter dan dapat berisi huruf kecil a hingga z, digit, tanda hubung (-), dan garis bawah (_).

    UserDefined
    ValueType

    string

    No

    Tipe konten nilai header. Nilai valid:

    • UserDefined: nilai header kustom.

    • ReferenceHeader: mereferensikan bidang dalam header permintaan.

    • SystemDefined: nilai header yang ditentukan sistem.

    UserDefined
    Order

    integer

    No

    Prioritas Pesanan dalam aturan pengalihan. Nilai valid: 1 hingga 50000. Aksi dijalankan berdasarkan urutan prioritas ascending. Nilai ini tidak boleh kosong atau duplikat. Anda dapat menentukan hingga 20 prioritas aksi.

    1
    RedirectConfig

    object

    No

    Konfigurasi redirect. Anda dapat menambahkan hingga 20 redirect.

    Host

    string

    No

    Host tujuan redirect. Nilai valid:

    • ${host} (default): nilai ini tidak dapat digabungkan dengan karakter lain.

    • Nilai lainnya. Batasan set karakter dan format adalah sebagai berikut:

      • Panjang hostname harus 3 hingga 256 karakter dan dapat berisi huruf kecil a hingga z, digit, tanda hubung (-), titik (.), asterisk (*), dan tanda tanya (?).

      • Hostname harus mengandung setidaknya satu titik (.). Titik (.) tidak boleh muncul di awal atau akhir.

      • Label domain paling kanan hanya dapat berisi huruf dan wildcard. Label ini tidak boleh berisi digit atau tanda hubung (-).

      • Tanda hubung (-) tidak boleh muncul di awal atau akhir label domain lainnya.

      • Asterisk (*) dan tanda tanya (?) dapat muncul di posisi mana pun dalam label domain.

    www.example.com
    HttpCode

    string

    No

    Tipe redirect. Nilai valid: 301, 302, 303, 307, dan 308.

    301
    Path

    string

    No

    Path tujuan redirect. Nilai valid:

    • ${path} (default): Anda dapat mereferensikan ${host}, ${protocol}, dan ${port}. Setiap variabel dapat muncul paling banyak sekali. Variabel ini dapat digunakan bersama atau digabungkan dengan karakter dalam rentang nilai yang diizinkan seperti tercantum di bawah.

    • Nilai lainnya. Batasan set karakter dan format adalah sebagai berikut:

      • Panjang path harus 1 hingga 256 karakter.

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

    /test
    Port

    string

    No

    Port tujuan redirect. Nilai valid:

    • ${port} (default): nilai ini hanya dapat digunakan sendiri dan tidak dapat digabungkan dengan karakter lain.

    • Nilai lainnya: 1 hingga 63335.

    10
    Protocol

    string

    No

    Protokol Port tujuan redirect. Nilai valid:

    • ${protocol} (default): nilai ini tidak dapat digabungkan dengan karakter lain.

    • HTTP atau HTTPS.

    Catatan

    Pendengar HTTPS hanya mendukung redirect ke HTTPS.

    HTTP
    Query

    string

    No

    Kueri string tujuan redirect. Nilai valid:

    • ${query} (default): Anda dapat mereferensikan ${host}, ${protocol}, dan ${port}. Setiap variabel dapat muncul paling banyak sekali. Variabel ini dapat digunakan bersama atau digabungkan dengan karakter dalam rentang nilai yang diizinkan seperti tercantum di bawah.

    • Nilai lainnya. Batasan set karakter dan format adalah sebagai berikut:

      • Panjang kueri string harus 1 hingga 128 karakter.

      • Kueri string dapat berisi karakter yang dapat dicetak tetapi tidak boleh berisi spasi atau #[]{}\|<>". Huruf harus huruf kecil.

    quert
    RewriteConfig

    object

    No

    Konfigurasi menulis ulang.

    Host

    string

    No

    Alamat host tujuan untuk redirect internal. Nilai valid:

    • ${host} (default): nilai ini tidak dapat digabungkan dengan karakter lain.

    • Nilai lainnya. Batasan set karakter dan format adalah sebagai berikut:

      • Panjang hostname harus 3 hingga 256 karakter dan dapat berisi huruf kecil a hingga z, digit, tanda hubung (-), titik (.), asterisk (*), dan tanda tanya (?).

      • Hostname harus mengandung setidaknya satu titik (.). Titik (.) tidak boleh muncul di awal atau akhir.

      • Label domain paling kanan hanya dapat berisi huruf dan wildcard. Label ini tidak boleh berisi digit atau tanda hubung (-).

      • Tanda hubung (-) tidak boleh muncul di awal atau akhir label domain lainnya. Asterisk (*) dan tanda tanya (?) dapat muncul di posisi mana pun dalam label domain.

    www.example.com
    Path

    string

    No

    Path tujuan redirect. Nilai valid:

    • ${path} (default): Anda dapat mereferensikan ${host}, ${protocol}, dan ${port}. Setiap variabel dapat muncul paling banyak sekali. Variabel ini dapat digunakan bersama atau digabungkan dengan karakter dalam rentang nilai yang diizinkan seperti tercantum di bawah.

    • Nilai lainnya. Batasan set karakter dan format adalah sebagai berikut:

      • Panjang path harus 1 hingga 256 karakter.

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

    /tsdf
    Query

    string

    No

    Kueri string untuk redirect internal. Nilai valid:

    • ${query} (default): Anda dapat mereferensikan ${host}, ${protocol}, dan ${port}. Setiap variabel dapat muncul paling banyak sekali. Variabel ini dapat digunakan bersama atau digabungkan dengan karakter dalam rentang nilai yang diizinkan seperti tercantum di bawah.

    • Nilai lainnya. Batasan set karakter dan format adalah sebagai berikut:

      • Panjang kueri string harus 1 hingga 128 karakter.

      • Kueri string dapat berisi karakter yang dapat dicetak tetapi tidak boleh berisi spasi atau #[]{}\|<>". Huruf harus huruf kecil.

    quedsa
    Type

    string

    No

    Tipe aksi. Anda dapat menambahkan hingga 11 tipe aksi. Nilai valid:

    • ForwardGroup: meneruskan permintaan ke beberapa layanan virtual.

    • Redirect: mengalihkan permintaan.

    • FixedResponse: mengembalikan tanggapan 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 mengandung satu aksi ForwardGroup, Redirect, atau FixedResponse. Ketika aksi ini berdampingan dengan tipe aksi lain, aksi ini harus menjadi aksi terakhir yang dijalankan.

    ForwardGroup
    TrafficLimitConfig

    object

    No

    Konfigurasi pembatasan kecepatan Trafik.

    QPS

    integer

    No

    Queries per second (QPS). Nilai valid: 1 hingga 1000000.

    100
    PerIpQps

    integer

    No

    QPS per alamat IP. Nilai valid: 1 hingga 1000000.

    Catatan

    Jika QPS dan PerIpQps keduanya dikonfigurasi, nilai PerIpQps harus lebih kecil dari nilai QPS.

    80
    TrafficMirrorConfig

    object

    No

    Konfigurasi Pencerminan lalu lintas.

    TargetType

    string

    No

    Tipe target cermin. Nilai valid:

    • ForwardGroupMirror: mencerminkan Trafik ke kelompok server.

    ForwardGroupMirror
    MirrorGroupConfig

    object

    No

    Konfigurasi untuk mencerminkan Trafik ke kelompok server.

    ServerGroupTuples

    array<object>

    No

    The server group to which traffic is mirrored.

    object

    No

    The server group to which traffic is mirrored.

    ServerGroupId

    string

    No

    The ID of the server group.

    srg-00mkgijak0w4qgz9****
    RemoveHeaderConfig

    object

    No

    Konfigurasi hapus header.

    Key

    string

    No

    Nama header yang akan dihapus. Panjang nama harus 1 hingga 40 karakter dan dapat berisi huruf besar dan kecil a hingga z, digit, garis bawah (_), dan tanda hubung (-). Nama header tidak boleh duplikat dalam RemoveHeader.

    • Arah permintaan (Direction diatur ke Request): nama header tidak boleh diatur ke bidang berikut (tidak peka huruf besar/kecil): slb-id, slb-ip, x-forwarded-for, x-forwarded-proto, x-forwarded-eip, x-forwarded-port, x-forwarded-client-srcport, x-forwarded-host, connection, Peningkatan, content-length, transfer-encoding, keep-alive, te, host, cookie, remoteip, authority.

    • Arah tanggapan (Direction diatur ke Response): nama header tidak boleh diatur ke bidang berikut (tidak peka huruf besar/kecil): connection, Peningkatan, content-length, transfer-encoding.

    test
    CorsConfig

    object

    No

    Konfigurasi berbagi sumber daya lintas asal (CORS).

    AllowOrigin

    array

    No

    Daftar asal yang diizinkan. Anda dapat mengonfigurasi satu elemen * atau satu atau beberapa nilai.

    • Setiap nilai harus dimulai dengan http:// atau https://, diikuti oleh nama domain yang valid atau nama domain wildcard tingkat pertama (misalnya, http://*.test.abc.example.com).

    • Setiap nilai dapat secara opsional menyertakan port. Range port: 1 hingga 65535.

    string

    No

    Asal yang diizinkan.

    http://test.com
    AllowMethods

    array

    No

    Metode HTTP yang diizinkan untuk akses lintas asal.

    string

    No

    Metode HTTP yang diizinkan untuk akses lintas asal. Nilai valid:

    • GET.

    • POST.

    • PUT.

    • DELETE.

    • HEAD.

    • OPTIONS.

    • PATCH.

    GET
    AllowHeaders

    array

    No

    Daftar header yang diizinkan untuk akses lintas asal.

    string

    No

    Header yang diizinkan untuk akses lintas asal. Anda dapat mengatur ini ke * atau satu atau beberapa nilai yang dipisahkan oleh koma (,). Setiap nilai hanya dapat berisi huruf besar dan kecil, digit, serta garis bawah (_) dan tanda hubung (-) yang tidak berada di awal atau akhir. Panjang maksimum setiap nilai adalah 32 karakter.

    test_123
    ExposeHeaders

    array

    No

    Daftar header yang dapat diekspos.

    string

    No

    Header yang dapat diekspos. Anda dapat mengatur ini ke * atau satu atau beberapa nilai yang dipisahkan oleh koma (,). Setiap nilai hanya dapat berisi huruf besar dan kecil, digit, serta garis bawah (_) dan tanda hubung (-) yang tidak berada di awal atau akhir. Panjang maksimum setiap nilai adalah 32 karakter.

    test_123
    AllowCredentials

    string

    No

    Apakah akan mengizinkan kredensial. Nilai valid:

    • on: Mengizinkan kredensial.

    • off: Tidak mengizinkan kredensial.

    on
    MaxAge

    integer

    No

    Pengatur waktu cache maksimum untuk permintaan preflight di browser. Unit: detik.

    Nilai valid: -1 hingga 172800.

    1000
    RuleName

    string

    No

    Nama aturan pengalihan. Panjang nama harus 2 hingga 128 karakter dan dapat berisi huruf, digit, titik (.), garis bawah (_), tanda hubung (-), dan spasi. Nama harus dimulai dengan huruf, karakter Tiongkok, atau digit.

    rule-instance-test
    Priority

    integer

    No

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

    Catatan

    Prioritas aturan dalam pendengar yang sama harus unik.

    10

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Tanggapan untuk memperbarui atribut aturan pengalihan.

    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.
    400 OperationDenied.SameGroupForForwardAndMirrorAction 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.
    400 QuotaExceeded.RuleMatchEvaluationsNum The quota of %s is exceeded, usage %s/%s.
    400 QuotaExceeded.RuleActionsNum The quota of %s is exceeded, usage %s/%s.
    400 Mismatch.Protocol The %s is mismatched for %s and %s.
    400 Mismatch.VpcId The %s is mismatched for %s and %s.
    400 OperationDenied.RewriteMissingForwardGroup The operation is not allowed because of RewriteMissingForwardGroup.
    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.
    404 ResourceNotFound.Rule 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.