全部產品
Search
文件中心

Microservices Engine:ApplyTagPolicies - 修改標籤路由規則

更新時間:Dec 16, 2025

修改標籤路由規則。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊,可以在RAM權限原則語句的Action元素中使用,用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下:

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

mse:ApplyTagPolicies

update

*全部資源

*

請求參數

名稱

類型

必填

描述

樣本值

Region

string

地區。

cn-hangzhou

Namespace

string

應用所屬的 MSE 命名空間

default

AppName

string

應用程式名稱字

example-app

AppId deprecated

string

應用 ID。

h5pohqu3gd@xxx

Rules

object

路由規則。

object

Status

integer

狀態。

枚舉值:

  • 0 :

    未生效

  • 1 :

    生效

  • 2 :

    失效

0

Rate

integer

百分比。

10

Enable

boolean

是否開啟。

true

Tag

string

這個路由規則的環境。

gray

Name

string

路由規則名稱。

gray

Id

integer

規則 ID。

1

InstanceNum

integer

執行個體數量。

10

Rules

object

規則資訊。

springcloud

array<object>

springcloud 規則。

array<object>

condition

string

下面 items 各項中的邏輯運算關係。可選 AND 或者 OR。

AND

restItems

array<object>

object

datum

string

rawvalue 等操作符需要比較的值。

10

operator

string

操作符。rawvalue 表示直接比較,mode 表示模數,list 表示白名單。

rawvalue

nameList

array

list 操作符需要的欄位。

string

名稱。

test1

cond

string

比較符號,可取 >=, <=, >, <, == 。

==

divisor

integer

mod 操作符需要的欄位,除數。

30

remainder

integer

百分比操作需要的欄位,百分比值。

30

rate

integer

比例規則,20% 的流量路由到該標籤對應的節點。

20

type

string

類型。

test

name

string

名稱。

key

value

any

值。

test

triggerPolicy

string

策略類型。

枚舉值:

  • PERCENT :

    比例規則

  • CONTENT :

    內容匹配規則

CONTENT

enable

boolean

是否開啟。

true

appId

string

應用 ID。

***@***

priority

integer

優先順序。

1

tags

array

標籤列表。

string

標籤。

gray

paths

array

路徑列表。

string

路徑。

/hello

path

string

路徑。

/hello

dubbo

array<object>

dubbo 規則。

array<object>

規則內容。

appId

string

應用 ID。

***@***

tags

array

標籤列表。

string

標籤。

gray

triggerPolicy

string

策略類型。

CONTENT

serviceName

string

服務名(介面)。

HelloService

group

string

dubbo 服務分組。

default

version

string

dubbo 服務版本。

1.0.0

methodName

string

dubbo 服務的方法名。

hello

paramTypes

array

參數類型列表。

string

參數類型。

int

condition

string

下面 items 各項中的邏輯運算關係。可選 AND 或者 OR。

AND

argumentItems

array<object>

參數內容列表。

object

參數內容。

operator

string

操作符。rawvalue 表示直接比較,mode 表示模數,list 表示白名單。

rawvalue

nameList

array

名稱列表。

string

名稱。

demo

datum

string

rawvalue 等操作符需要比較的值。

30

cond

string

比較符號,可取 >=, <=, >, <, == 。

==

divisor

integer

mod 操作符需要的欄位,除數。

30

remainder

integer

百分比操作需要的欄位,百分比值。

30

rate

integer

比例規則,20% 的流量路由到該標籤對應的節點。

10

index

integer

參數位置,從 0 開始。

0

expr

string

運算式,見其他欄位解釋。

value

any

比較的值。運算式得到的值會跟這個值比較。如果 operator 是 list 白名單,value 的值用 "," 分隔,比如 1,2,3。

1,2,3

NamespaceId

string

命名空間 ID,可以不填。

12233****

Enable

boolean

是否開啟。

true

AcceptLanguage

string

返回資訊的語言類型:

  • zh:中文

  • en:英文

zh

返回參數

名稱

類型

描述

樣本值

object

Message

string

響應資訊。

success

RequestId

string

請求 ID。

316F5F64-F73D-42DC-8632-01E308B6****

Data

array<object>

資料概覽

object

資料概覽

Status

integer

生效狀態

1

InstanceNum

integer

執行個體數量

1

Remove

boolean

是否刪除成功。

CarryData

boolean

是否為主鍵。

true

Tag

string

標籤。

gray

Name

string

策略名稱稱

test

Rules

string

標籤規則

{\"_base\": {\"rate\": 100, \"remove\": true}, \"blue\": {\"rate\": 0}}

Id

integer

主鍵 ID。

12

Rate

integer

比例

10

Enable

boolean

開啟或關閉。

  • true:開啟。

  • false:關閉。

true

Success

boolean

請求結果

true

樣本

正常返回樣本

JSON格式

{
  "Message": "success",
  "RequestId": "316F5F64-F73D-42DC-8632-01E308B6****",
  "Data": [
    {
      "Status": 1,
      "InstanceNum": 1,
      "Remove": true,
      "CarryData": true,
      "Tag": "gray",
      "Name": "test",
      "Rules": "{\\\"_base\\\": {\\\"rate\\\": 100, \\\"remove\\\": true}, \\\"blue\\\": {\\\"rate\\\": 0}}",
      "Id": 12,
      "Rate": 10,
      "Enable": true
    }
  ],
  "Success": true
}

錯誤碼

HTTP status code

錯誤碼

錯誤資訊

描述

400 IllegalRequest Invalid request:%s 非法請求: %s
400 InvalidParameter Parameter error:%s 請求參數錯誤:%s
500 InternalError Console error. Try again later:%s 控制台錯誤.稍後重試:%s
403 NoPermission You are not authorized to perform this operation:%s 沒有許可權使用此介面:%s
404 NotFound Not found:%s 資源不存在:%s

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情