文档

ApplyTagPolicies - 修改标签路由规则

更新时间:

修改标签路由规则。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
mse:ApplyTagPoliciesWrite
  • GovernanceApplication
    acs:mse:{#Region}:{#AccountId}:namespace/{#Namespace}/application/{#AppName}

请求参数

名称类型必填描述示例值
Regionstring

地域。

cn-hangzhou
Namespacestring

应用所属的 MSE 命名空间

default
AppNamestring

应用名字

example-app
AppIddeprecatedstring

应用 ID。

h5pohqu3gd@xxx
Rulesobject

路由规则。

object
Statusinteger

状态。

枚举值:
  • 0未生效
  • 1生效
  • 2失效
0
Rateinteger

百分比。

10
Enableboolean

是否开启。

true
Tagstring

这个路由规则的环境。

gray
Namestring

路由规则名称。

gray
Idlong

规则 ID。

1
InstanceNuminteger

实例数量。

10
Rulesobject

规则信息。

springcloudobject []

springcloud 规则。

conditionstring

下面 items 各项中的逻辑运算关系。可选 AND 或者 OR。

AND
restItemsobject []
datumstring

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

10
operatorstring

操作符。rawvalue 表示直接比较,mode 表示取模,list 表示白名单。

rawvalue
nameListarray

list 操作符需要的字段。

string

名称。

test1
condstring

比较符号,可取 >=, <=, >, <, == 。

==
divisorinteger

mod 操作符需要的字段,除数。

30
remainderinteger

百分比操作需要的字段,百分比值。

30
rateinteger

比例规则,20% 的流量路由到该标签对应的节点。

20
typestring

类型。

test
namestring

名称。

key
valueany

值。

test
triggerPolicystring

策略类型。

枚举值:
  • PERCENT比例规则
  • CONTENT内容匹配规则
CONTENT
enableboolean

是否开启。

true
appIdstring

应用 ID。

***@***
priorityinteger

优先级。

1
tagsarray

标签列表。

string

标签。

gray
pathsarray

路径列表。

string

路径。

/hello
pathstring

路径。

/hello
dubboobject []

dubbo 规则。

appIdstring

应用 ID。

***@***
tagsarray

标签列表。

string

标签。

gray
triggerPolicystring

策略类型。

CONTENT
serviceNamestring

服务名(接口)。

HelloService
groupstring

dubbo 服务分组。

default
versionstring

dubbo 服务版本。

1.0.0
methodNamestring

dubbo 服务的方法名。

hello
paramTypesarray

参数类型列表。

string

参数类型。

int
conditionstring

下面 items 各项中的逻辑运算关系。可选 AND 或者 OR。

AND
argumentItemsobject []

参数内容列表。

operatorstring

操作符。rawvalue 表示直接比较,mode 表示取模,list 表示白名单。

rawvalue
nameListarray

名称列表。

string

名称。

demo
datumstring

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

30
condstring

比较符号,可取 >=, <=, >, <, == 。

==
divisorinteger

mod 操作符需要的字段,除数。

30
remainderinteger

百分比操作需要的字段,百分比值。

30
rateinteger

比例规则,20% 的流量路由到该标签对应的节点。

10
indexinteger

参数位置,从 0 开始。

0
exprstring

表达式,见其他字段解释。

valueany

比较的值。表达式得到的值会跟这个值比较。如果 operator 是 list 白名单,value 的值用 "," 分隔,比如 1,2,3。

1,2,3
NamespaceIdstring

命名空间 ID,可以不填。

12233****
Enableboolean

是否开启。

true
AcceptLanguagestring

返回信息的语言类型:

  • zh:中文
  • en:英文
zh

返回参数

名称类型描述示例值
object
Messagestring

响应信息。

success
RequestIdstring

请求 ID。

316F5F64-F73D-42DC-8632-01E308B6****
Dataobject []

数据概览

Statusinteger

生效状态

1
InstanceNuminteger

实例数量

1
Removeboolean

是否删除成功。

CarryDataboolean

是否为主键。

true
Tagstring

标签。

gray
Namestring

策略名称

test
Rulesstring

标签规则

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

主键 ID。

12
Rateinteger

比例

10
Enableboolean

开启或关闭。

  • true:开启。
  • false:关闭。
true
Successboolean

请求结果

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错误码错误信息描述
400IllegalRequestInvalid request:%s非法请求: %s
400InvalidParameterParameter error:%s请求参数错误:%s
403NoPermissionYou are not authorized to perform this operation:%s没有权限使用此接口:%s
404NotFoundNot found:%s资源不存在:%s
500InternalErrorConsole error. Try again later:%s控制台错误.稍后重试:%s

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
2023-09-06API 内部配置变更,不影响调用看变更集
变更项变更内容
API 内部配置变更,不影响调用
2023-09-06API 内部配置变更,不影响调用看变更集
变更项变更内容
API 内部配置变更,不影响调用
2023-08-16API 内部配置变更,不影响调用看变更集
变更项变更内容
API 内部配置变更,不影响调用
2023-07-07API 内部配置变更,不影响调用看变更集
变更项变更内容
API 内部配置变更,不影响调用
2023-07-06OpenAPI 入参发生变更、OpenAPI 返回结构发生变更看变更集
变更项变更内容
入参OpenAPI 入参发生变更
    删除入参:Source
出参OpenAPI 返回结构发生变更
2023-03-24OpenAPI 描述信息更新、OpenAPI 入参发生变更看变更集
变更项变更内容
API 描述OpenAPI 描述信息更新
入参OpenAPI 入参发生变更
    新增入参:Namespace
    新增入参:AppName
  • 本页导读 (1)