Operasi ini mengkueri aturan pengalihan di wilayah yang ditentukan.
Coba sekarang
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
alb:ListRules |
get |
*LoadBalancer
|
None | None |
Parameter permintaan
|
Parameter |
Type |
Required |
Description |
Example |
| NextToken |
string |
No |
Token yang digunakan untuk mengambil halaman hasil berikutnya. Nilai valid:
|
FFmyTO70tTpLG6I3FmYAXGKPd**** |
| MaxResults |
integer |
No |
Jumlah maksimum entri yang dikembalikan. Nilai valid: 1 hingga 100. Nilai default: 20. Catatan
Parameter ini bersifat opsional. |
20 |
| RuleIds |
array |
No |
ID aturan pengalihan. Anda dapat menentukan hingga 20 ID aturan pengalihan. |
|
|
string |
No |
ID aturan pengalihan. |
rule-sada****** |
|
| ListenerIds |
array |
No |
ID listener. Anda dapat menentukan hingga 20 ID listener. |
|
|
string |
No |
ID listener. |
lsn-i35udpz3pxsmnf**** |
|
| LoadBalancerIds |
array |
No |
ID instans SLB. Anda dapat menentukan hingga 20 ID instans. |
|
|
string |
No |
ID instans SLB. |
alb-x30o38azsuj0sx**** |
|
| Direction |
string |
No |
Arah aturan pengalihan. Nilai valid:
Catatan
Instans ALB dasar tidak mendukung tipe Response. |
Request |
| Tag |
array<object> |
No |
Tag. |
|
|
object |
No |
Tag. |
||
| Key |
string |
No |
Kunci tag. Panjang kunci tag dapat mencapai 128 karakter. Tidak boleh diawali dengan `aliyun` atau `acs:`, serta tidak boleh mengandung `http://` atau `https://`. |
env |
| Value |
string |
No |
Nilai tag. Panjang nilai tag dapat mencapai 128 karakter. Tidak boleh diawali dengan `aliyun` atau `acs:`, serta tidak boleh mengandung `http://` atau `https://`. |
product |
Elemen respons
|
Element |
Type |
Description |
Example |
|
object |
Aturan pengalihan. |
||
| MaxResults |
integer |
Jumlah maksimum entri yang dikembalikan per halaman. |
50 |
| NextToken |
string |
Token yang digunakan untuk mengambil halaman hasil berikutnya. Nilai valid:
|
FFmyTO70tTpLG6I3FmYAXGKPd**** |
| RequestId |
string |
ID permintaan. |
CEF72CEB-54B6-4AE8-B225-F876F****** |
| Rules |
array<object> |
Daftar aturan pengalihan. |
|
|
array<object> |
Aturan pengalihan. |
||
| ListenerId |
string |
ID listener tempat aturan pengalihan berada. |
lsn-i35udpz3pxsmnf**** |
| LoadBalancerId |
string |
ID instans SLB tempat aturan pengalihan berada. |
alb-x30o38azsuj0sx**** |
| Priority |
integer |
Prioritas aturan. Nilai yang lebih kecil menunjukkan prioritas yang lebih tinggi. Nilai valid: 1 hingga 10000. Catatan
Prioritas setiap aturan harus unik dalam satu listener. |
1 |
| RuleActions |
array<object> |
Aksi aturan pengalihan. |
|
|
array<object> |
Aksi aturan pengalihan. |
||
| FixedResponseConfig |
object |
Konfigurasi respons tetap. |
|
| Content |
string |
Respons tetap. Panjang respons maksimal 1 KB dan hanya boleh berisi karakter ASCII. |
dssacav |
| ContentType |
string |
Format respons tetap. Nilai valid: text/plain, text/css, text/html, application/javascript, dan application/json. |
text/plain |
| HttpCode |
string |
Kode status HTTP respons. Hanya mendukung HTTP_2xx, HTTP_4xx, dan HTTP_5xx. x adalah angka. |
HTTP_2xx |
| ForwardGroupConfig |
object |
Konfigurasi grup pengalihan. |
|
| ServerGroupTuples |
array<object> |
Grup server tujuan. |
|
|
object |
Grup server tujuan. |
||
| ServerGroupId |
string |
ID grup server tujuan. |
sgp-atstuj3rtoptyui**** |
| Weight |
integer |
Bobot. Nilai valid: 0 hingga 100. |
2 |
| ServerGroupStickySession |
object |
Pengaturan persistensi sesi untuk grup server. |
|
| Enabled |
boolean |
Menentukan apakah persistensi sesi di antara grup server diaktifkan. Parameter ini tersedia ketika beberapa grup server ditentukan dalam `ServerGroupTuples`. |
|
| Timeout |
integer |
Periode timeout untuk persistensi sesi. Parameter ini tersedia ketika `Enabled` disetel ke `true`. |
100 |
| InsertHeaderConfig |
object |
Konfigurasi header yang akan dimasukkan. |
|
| Key |
string |
Kunci header yang akan dimasukkan. Panjang kunci harus 1 hingga 40 karakter. Dapat berisi huruf, angka, garis bawah (_), dan tanda hubung (-). Kunci header dalam Catatan
Anda tidak dapat menyetel kunci ke Cookie atau Host. |
key |
| Value |
string |
Nilai header yang akan dimasukkan.
|
ClientSrcPort |
| ValueType |
string |
Tipe nilai header. Nilai valid:
|
SystemDefined |
| Order |
integer |
Urutan aksi. Nilai valid: 1 hingga 50000. Nilai yang lebih kecil menunjukkan prioritas yang lebih tinggi. Nilai parameter ini tidak boleh sama dengan nilai Order untuk aksi lain dalam aturan yang sama. |
1 |
| RedirectConfig |
object |
Konfigurasi pengalihan. |
|
| Host |
string |
Host tujuan tempat permintaan dialihkan. Nilai valid:
|
www.example.com |
| HttpCode |
string |
Metode pengalihan. Nilai valid: 301, 302, 303, 307, dan 308. |
301 |
| Path |
string |
Jalur tujuan tempat permintaan dialihkan. Nilai valid:
|
/test |
| Port |
string |
Port tujuan tempat permintaan dialihkan. Nilai valid:
|
10 |
| Protocol |
string |
Protokol tujuan tempat permintaan dialihkan. Nilai valid:
Catatan
Listener HTTPS hanya mendukung HTTPS. |
HTTP |
| Query |
string |
String kueri tujuan tempat permintaan dialihkan. Panjang string kueri harus 1 hingga 128 karakter. Dapat berisi huruf kecil dan karakter yang dapat dicetak. Tidak boleh berisi |
quert |
| RemoveHeaderConfig |
object |
Konfigurasi untuk menghapus header. |
|
| Key |
string |
Kunci header yang akan dihapus. Panjang kunci harus 1 hingga 40 karakter. Dapat berisi huruf, angka, garis bawah (_), dan tanda hubung (-). Kunci header dalam RemoveHeader tidak boleh sama dengan kunci header yang telah dihapus.
|
key |
| RewriteConfig |
object |
Konfigurasi penulisan ulang. |
|
| Host |
string |
Host tujuan tempat permintaan dialihkan. Nilai valid:
|
www.example.com |
| Path |
string |
Jalur tujuan tempat permintaan dialihkan. Panjang jalur harus 1 hingga 128 karakter. Harus diawali dengan garis miring (/). Dapat berisi huruf, angka, tanda bintang (*), tanda tanya (?), dan karakter khusus berikut: |
/tsdf |
| Query |
string |
String kueri tujuan tempat permintaan dialihkan. Panjang string kueri harus 1 hingga 128 karakter. Dapat berisi huruf kecil dan karakter yang dapat dicetak. Tidak boleh berisi |
quedsa |
| TrafficMirrorConfig |
object |
Konfigurasi pencerminan lalu lintas. |
|
| TargetType |
string |
Tujuan pencerminan lalu lintas. Nilainya dapat berupa `ForwardGroupMirror`. |
ForwardGroupMirror |
| MirrorGroupConfig |
object |
Grup server tempat lalu lintas dicerminkan. |
|
| ServerGroupTuples |
array<object> |
Grup server tempat lalu lintas dicerminkan. |
|
|
object |
|||
| ServerGroupId |
string |
ID grup server. |
sgp-00mkgijak0w4qgz9**** |
| Weight |
integer |
Bobot. Nilai valid: 0 hingga 100. |
2 |
| TrafficLimitConfig |
object |
Konfigurasi pembatasan kecepatan. |
|
| QPS |
integer |
Permintaan per detik (QPS). Nilai valid: 1 hingga 100000. |
4 |
| PerIpQps |
integer |
QPS alamat IP tunggal. Nilai valid: 1 hingga 100000. Catatan
Jika Anda menyetel QPS dan PerIpQps, nilai PerIpQps harus lebih kecil dari nilai QPS. |
80 |
| Type |
string |
Tipe aksi. Nilai valid:
|
ForwardGroup |
| CorsConfig |
object |
Konfigurasi CORS. |
|
| AllowOrigin |
array |
Asal yang diizinkan. |
|
|
string |
Asal yang diizinkan. Anda dapat menyetel nilai ke
|
http://test.com |
|
| AllowMethods |
array |
Metode HTTP yang diizinkan untuk permintaan lintas asal. |
|
|
string |
Metode HTTP yang diizinkan untuk permintaan lintas asal. Nilai valid:
|
GET |
|
| AllowHeaders |
array |
Header yang diizinkan untuk permintaan lintas asal. |
|
|
string |
Header yang diizinkan untuk permintaan lintas asal. Anda dapat menyetel nilai ke |
test_123 |
|
| ExposeHeaders |
array |
Header yang dapat diekspos ke browser. |
|
|
string |
Header yang dapat diekspos ke browser. Anda dapat menyetel nilai ke |
test_123 |
|
| AllowCredentials |
string |
Menentukan apakah browser dapat mengirim kredensial. Nilai valid:
|
on |
| MaxAge |
integer |
Waktu cache maksimum permintaan preflight di browser. Satuan: detik. Nilai valid: -1 hingga 172800. |
1000 |
| RuleConditions |
array<object> |
Kondisi aturan pengalihan. |
|
|
array<object> |
Kondisi aturan pengalihan. |
||
| CookieConfig |
object |
Konfigurasi cookie. |
|
| Values |
array<object> |
Nilai cookie. |
|
|
object |
Nilai cookie. |
||
| Key |
string |
Kunci cookie. Panjang kunci harus 1 hingga 100 karakter. Dapat berisi huruf kecil, karakter yang dapat dicetak, tanda bintang (*), dan tanda tanya (?). Tidak boleh berisi spasi atau karakter khusus berikut: |
test |
| Value |
string |
Nilai cookie. Panjang nilai harus 1 hingga 128 karakter. Dapat berisi huruf kecil, karakter yang dapat dicetak, tanda bintang (*), dan tanda tanya (?). Tidak boleh berisi spasi atau karakter khusus berikut: |
test |
| HeaderConfig |
object |
Konfigurasi header. |
|
| Key |
string |
Kunci header. Panjang kunci harus 1 hingga 40 karakter. Dapat berisi huruf, angka, tanda hubung (-), dan garis bawah (_). Anda tidak dapat menyetel kunci ke Cookie atau Host. |
Port |
| Values |
array |
Nilai header. |
|
|
string |
Nilai header. Panjang nilai harus 1 hingga 128 karakter. Dapat berisi karakter yang dapat dicetak dengan nilai ASCII dari |
5006 |
|
| HostConfig |
object |
Konfigurasi host. |
|
| Values |
array |
Hostname. |
|
|
string |
Hostname. Konvensi penamaan:
|
www.example.com |
|
| MethodConfig |
object |
Konfigurasi metode permintaan. |
|
| Values |
array |
Metode permintaan. |
|
|
string |
Metode permintaan. Nilai valid: HEAD, GET, POST, OPTIONS, PUT, PATCH, dan DELETE. |
PUT |
|
| PathConfig |
object |
Konfigurasi jalur. |
|
| Values |
array |
Jalur. |
|
|
string |
Jalur. Panjang jalur harus 1 hingga 128 karakter. Harus diawali dengan garis miring (/). Dapat berisi huruf, angka, tanda bintang (*), tanda tanya (?), dan karakter khusus berikut: |
/test |
|
| QueryStringConfig |
object |
Konfigurasi string kueri. |
|
| Values |
array<object> |
String kueri. |
|
|
object |
String kueri. |
||
| Key |
string |
Kunci string kueri. Panjang kunci harus 1 hingga 100 karakter. Dapat berisi huruf kecil, karakter yang dapat dicetak, tanda bintang (*), dan tanda tanya (?). Tidak boleh berisi spasi atau karakter khusus berikut: |
test |
| Value |
string |
Nilai string kueri. Panjang nilai harus 1 hingga 128 karakter. Dapat berisi huruf kecil, karakter yang dapat dicetak, tanda bintang (*), dan tanda tanya (?). Tidak boleh berisi spasi atau karakter khusus berikut: |
test |
| SourceIpConfig |
object |
Konfigurasi alamat IP sumber. |
|
| Values |
array |
Alamat IP sumber yang dicocokkan. |
|
|
string |
Tentukan satu atau beberapa alamat IP atau blok CIDR. Anda dapat menentukan hingga lima alamat IP sumber untuk setiap aturan pengalihan. |
192.168.XX.XX/32 |
|
| ResponseStatusCodeConfig |
object |
Konfigurasi kode status respons. |
|
| Values |
array |
Kode status respons. |
|
|
string |
Kode status respons. |
200 |
|
| ResponseHeaderConfig |
object |
Konfigurasi header HTTP respons. |
|
| Key |
string |
Kunci header HTTP respons. Panjang kunci harus 1 hingga 40 karakter. Dapat berisi huruf, angka, tanda hubung (-), dan garis bawah (_). Anda tidak dapat menyetel kunci ke Cookie atau Host. |
key |
| Values |
array |
Nilai header HTTP respons. |
|
|
string |
Nilai header HTTP respons. Panjang nilai harus 1 hingga 128 karakter. |
value |
|
| Type |
string |
Tipe aturan pengalihan. Nilai valid:
|
Host |
| RuleId |
string |
ID aturan pengalihan. |
rule-bpn0kn908w4nbw**** |
| RuleName |
string |
Nama aturan pengalihan. Panjang nama harus 2 hingga 128 karakter, diawali dengan huruf atau karakter Cina, dan dapat berisi huruf, angka, titik (.), garis bawah (_), dan tanda hubung (-). |
rule-instance-test |
| RuleStatus |
string |
Status aturan pengalihan. Nilai valid:
|
Available |
| Direction |
string |
Arah aturan pengalihan. Nilai valid:
Catatan
Instans ALB dasar tidak mendukung tipe Response. |
Request |
| Tags |
array<object> |
Tag. |
|
|
object |
Tag. |
||
| Key |
string |
Kunci tag. Panjang kunci tag dapat mencapai 128 karakter. Tidak boleh diawali dengan `aliyun` atau `acs:`, serta tidak boleh mengandung `http://` atau `https://`. |
env |
| Value |
string |
Nilai tag. Panjang nilai tag dapat mencapai 128 karakter. Tidak boleh diawali dengan `aliyun` atau `acs:`, serta tidak boleh mengandung `http://` atau `https://`. |
product |
| TotalCount |
integer |
Jumlah total entri yang dikembalikan. |
1000 |
Contoh
Respons sukses
JSONformat
{
"MaxResults": 50,
"NextToken": "FFmyTO70tTpLG6I3FmYAXGKPd****",
"RequestId": "CEF72CEB-54B6-4AE8-B225-F876F******",
"Rules": [
{
"ListenerId": "lsn-i35udpz3pxsmnf****",
"LoadBalancerId": "alb-x30o38azsuj0sx****",
"Priority": 1,
"RuleActions": [
{
"FixedResponseConfig": {
"Content": "dssacav",
"ContentType": "text/plain",
"HttpCode": "HTTP_2xx"
},
"ForwardGroupConfig": {
"ServerGroupTuples": [
{
"ServerGroupId": "sgp-atstuj3rtoptyui****",
"Weight": 2
}
],
"ServerGroupStickySession": {
"Enabled": false,
"Timeout": 100
}
},
"InsertHeaderConfig": {
"Key": "key",
"Value": "ClientSrcPort",
"ValueType": "SystemDefined"
},
"Order": 1,
"RedirectConfig": {
"Host": "www.example.com",
"HttpCode": "301",
"Path": "/test",
"Port": "10",
"Protocol": "HTTP",
"Query": "quert"
},
"RemoveHeaderConfig": {
"Key": "key"
},
"RewriteConfig": {
"Host": "www.example.com",
"Path": "/tsdf",
"Query": "quedsa"
},
"TrafficMirrorConfig": {
"TargetType": "ForwardGroupMirror",
"MirrorGroupConfig": {
"ServerGroupTuples": [
{
"ServerGroupId": "sgp-00mkgijak0w4qgz9****",
"Weight": 2
}
]
}
},
"TrafficLimitConfig": {
"QPS": 4,
"PerIpQps": 80
},
"Type": "ForwardGroup",
"CorsConfig": {
"AllowOrigin": [
"http://test.com"
],
"AllowMethods": [
"GET"
],
"AllowHeaders": [
"test_123"
],
"ExposeHeaders": [
"test_123"
],
"AllowCredentials": "on",
"MaxAge": 1000
}
}
],
"RuleConditions": [
{
"CookieConfig": {
"Values": [
{
"Key": "test",
"Value": "test"
}
]
},
"HeaderConfig": {
"Key": "Port",
"Values": [
"5006"
]
},
"HostConfig": {
"Values": [
"www.example.com"
]
},
"MethodConfig": {
"Values": [
"PUT"
]
},
"PathConfig": {
"Values": [
"/test"
]
},
"QueryStringConfig": {
"Values": [
{
"Key": "test",
"Value": "test"
}
]
},
"SourceIpConfig": {
"Values": [
"192.168.XX.XX/32"
]
},
"ResponseStatusCodeConfig": {
"Values": [
"200"
]
},
"ResponseHeaderConfig": {
"Key": "key",
"Values": [
"value"
]
},
"Type": "Host"
}
],
"RuleId": "rule-bpn0kn908w4nbw****",
"RuleName": "rule-instance-test",
"RuleStatus": "Available",
"Direction": "Request",
"Tags": [
{
"Key": "env",
"Value": "product"
}
]
}
],
"TotalCount": 1000
}
Kode kesalahan
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 403 | Forbidden.LoadBalancer | Authentication is failed for %s. |
Lihat Error Codes untuk daftar lengkap.
Catatan rilis
Lihat Release Notes untuk daftar lengkap.