All Products
Search
Document Center

Microservices Engine:UpdateWebFlowRule

Last Updated:Jun 10, 2026

Memperbarui aturan perlindungan parameter hot untuk permintaan HTTP.

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

mse:UpdateWebFlowRule

update

*All Resource

*

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

Namespace

string

No

Namespace.

default

AppName

string

Yes

Nama aplikasi.

spring-cloud-a

Threshold

number

No

Ambang batas.

20

Enable

boolean

No

Status aturan. Nilai yang valid:

  • true (diaktifkan)

  • false (dinonaktifkan)

true

Burst

integer

No

Jumlah permintaan tambahan yang diizinkan untuk permintaan burst. Efeknya setara dengan jumlah maksimum token untuk algoritma token bucket.

0

AppId

string

No

ID aplikasi.

hkhon1****@c3df23522******

ControlBehavior

integer

No

Metode kontrol aliran. Nilai yang valid:

  • 0: kegagalan cepat

  • 2: menunggu dalam antrean

0

MaxQueueingTimeMs

integer

No

Periode waktu habis. Satuan: milidetik. Parameter ini wajib jika parameter ControlBehavior diatur ke 2.

200

ResourceMode

integer

No

Mode sumber daya. Nilai yang valid:

  • 0: mode nama sumber daya

0

ParamItem

string

No

Item deskripsi parameter, yang merupakan string JSON yang berisi pasangan kunci-nilai berikut:

  • parseStrategy: properti parameter (0: alamat IP klien. 1: host jarak jauh. 2: header. 3: parameter URL)

  • fieldName: nama header atau nama parameter URL. Anda harus menentukan kunci ini hanya jika parseStrategy diatur ke 2 atau 3

  • matchStrategy: metode untuk mencocokkan nilai properti. Anda harus menentukan kunci ini hanya jika parseStrategy diatur ke 2 atau 3 dan nilai properti dicocokkan. Nilai yang valid: 0 (kecocokan persis), 2 (kecocokan ekspresi reguler), dan 3 (kecocokan substring)

  • pattern: string yang dicocokkan. Anda harus menentukan kunci ini hanya jika parseStrategy diatur ke 2 atau 3 dan nilai properti dicocokkan

{"fieldName":"key","matchStrategy":2,"parseStrategy":2,"pattern":"value"}

MetricType

integer

No

Tipe ambang batas. Nilai yang valid:

  • 1: jumlah permintaan

1

StatIntervalMs

integer

No

Panjang jendela waktu. Satuan: milidetik.

1000

RegionId

string

No

Region.

cn-hangzhou

RuleId

integer

Yes

ID aturan.

1

AcceptLanguage

string

No

Bahasa yang ingin Anda gunakan untuk menampilkan hasil. Nilai yang valid: zh dan en. zh menunjukkan bahasa Tionghoa, yang merupakan nilai default. en menunjukkan bahasa Inggris.

zh

Elemen respons

Element

Type

Description

Example

object

Message

string

Pesan yang dikembalikan.

OK

RequestId

string

ID permintaan.

54973C90-F379-4372-9AA5-053A3F7****

Code

string

Kode respons.

200

Data

object

Data yang dikembalikan.

Namespace

string

Namespace.

default

StatIntervalMs

integer

Panjang jendela waktu. Satuan: milidetik.

1000

Id

integer

ID aturan.

1

AppName

string

Nama aplikasi.

spring-cloud-a

Resource

string

Nama sumber daya antarmuka.

/flow

ControlBehavior

integer

Metode kontrol aliran. Nilai yang valid:

  • 0: kegagalan cepat

  • 2: menunggu dalam antrean

0

ReourceMode

integer

Mode sumber daya. Nilai yang valid:

  • 0: mode nama sumber daya

0

MaxQueueingTimeMs

integer

Periode waktu habis untuk antrean ketika parameter ControlBehavior diatur ke 2. Satuan: milidetik.

200

Threshold

number

Ambang batas.

20

Enable

boolean

Status aturan. Nilai yang valid:

  • true (diaktifkan)

  • false (dinonaktifkan)

true

AppId

string

ID aplikasi.

hkhon1XXXX@54e1f42f37cXXXX

MetricType

integer

Tipe ambang batas. Nilai yang valid:

  • 1: jumlah permintaan

1

RegionId

string

Region.

cn-hangzhou

Burst

integer

Jumlah permintaan tambahan yang diizinkan untuk permintaan burst. Efeknya setara dengan jumlah maksimum token untuk algoritma token bucket.

0

ParamItem

string

Item deskripsi parameter, yang merupakan string JSON yang berisi pasangan kunci-nilai berikut:

  • parseStrategy: properti parameter (0: alamat IP klien. 1: host jarak jauh. 2: header. 3: parameter URL)

  • fieldName: nama header atau nama parameter URL. Anda harus menentukan kunci ini hanya jika parseStrategy diatur ke 2 atau 3

  • matchStrategy: metode untuk mencocokkan nilai properti. Anda harus menentukan kunci ini hanya jika parseStrategy diatur ke 2 atau 3 dan nilai properti dicocokkan. Nilai yang valid: 0 (kecocokan persis), 2 (kecocokan ekspresi reguler), dan 3 (kecocokan substring)

  • pattern: string yang dicocokkan. Anda harus menentukan kunci ini hanya jika parseStrategy diatur ke 2 atau 3 dan nilai properti dicocokkan

{"fieldName":"testKey","matchStrategy":2,"parseStrategy":2,"pattern":"testValue"}

Success

boolean

Menunjukkan apakah permintaan berhasil. Nilai yang valid:

  • true: Permintaan berhasil.

  • false: Permintaan gagal.

true

Contoh

Respons sukses

JSONformat

{
  "Message": "OK",
  "RequestId": "54973C90-F379-4372-9AA5-053A3F7****",
  "Code": "200",
  "Data": {
    "Namespace": "default",
    "StatIntervalMs": 1000,
    "Id": 1,
    "AppName": "spring-cloud-a",
    "Resource": "/flow",
    "ControlBehavior": 0,
    "ReourceMode": 0,
    "MaxQueueingTimeMs": 200,
    "Threshold": 20,
    "Enable": true,
    "AppId": "hkhon1XXXX@54e1f42f37cXXXX",
    "MetricType": 1,
    "RegionId": "cn-hangzhou",
    "Burst": 0,
    "ParamItem": "{\"fieldName\":\"testKey\",\"matchStrategy\":2,\"parseStrategy\":2,\"pattern\":\"testValue\"}"
  },
  "Success": true
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

400 IllegalRequest Invalid request:%s Invalid request: %s
400 InvalidParameter Parameter error:%s Request parameter error: %s
500 InternalError Console error. Try again later:%s Console error. Try again later: %s
403 NoPermission You are not authorized to perform this operation:%s You do not have the permission to use this interface:%s
404 NotFound Not found:%s The resource does not exist:%s

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.