UpdateGreyTagRoute
更新灰度规则
服务地址:
华东1(杭州)
输入参数
只看必填
Description规则描述
ScRulesSpring Cloud应用的灰度规则
DubboRulesDubbo应用的灰度规则
GreyTagRouteId灰度规则ID
AlbRulesAlb网关路由的灰度规则
插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

请求语法

PUT /pop/v1/sam/tagroute/greyTagRoute HTTP/1.1

请求参数

字段名称字段详情
Descriptionstring

规则描述。

示例值:灰度发布-地域灰度
ScRulesstring

Spring Cloud 应用的灰度规则。

示例值:[{"condition":"OR","items":[{"cond":"==","name":"grey","operator":"rawvalue","type":"param","value":"true"},{"cond":"==","name":"grey","operator":"rawvalue","type":"cookie","value":"true"},{"cond":"==","name":"grey","operator":"rawvalue","type":"header","value":"true"}],"path":"/post-echo/hi"}]
DubboRulesstring

Dubbo 应用的灰度规则。

示例值:[{"condition":"OR","group":"DUBBO","items":[{"cond":"==","expr":".key1","index":0,"operator":"rawvalue","value":"value1"},{"cond":"==","expr":".key2","index":0,"operator":"rawvalue","value":"value2"}],"methodName":"echo","serviceName":"com.alibaba.edas.boot.EchoService","version":"1.0.0"}]
GreyTagRouteIdinteger<int64>

灰度规则 ID。

注意 该字段类型为 Long,在序列化/反序列化的过程中可能导致精度丢失,请注意数值不得大于 9007199254740991。
示例值:1参考取值来源:
    ListGreyTagRoute
    CreateGreyTagRoute
AlbRulesstring

Alb 网关路由的灰度规则。

示例值:[{"condition":"AND","items":[{"cond":"==","name":"grey","operator":"rawvalue","type":"sourceIp","value":"127.0.0.1"},{"cond":"==","name":"grey","operator":"rawvalue","type":"cookie","value":"true"},{"cond":"==","name":"grey","operator":"rawvalue","type":"header","value":"true"}],"path":"/post-echo/hi"}]

请求说明

  • ScRules 参数说明
参数名称类型示例描述
conditionStringOR灰度规则的条件模式,取值说明如下:
- AND:表示与,即同时满足条件列表中的所有条件。
- OR:表示或,即满足条件列表中的任一条件。
pathString/pathSpring Cloud 应用灰度规则对应的路径。
itemsArray of items条件列表。

items 参数说明

参数名称类型示例描述
nameStringtest参数名。
condString==比较操作符。可取值:><>=<===以及!=
typeStringcookie比较类型,取值说明如下:
- param:表示 Parameter。
- cookie:表示 Cookie。
- header:表示 Header。
valueStringtest参数取值,根据 typename 得到的值跟这个值进行比较。
operatorStringrawvalue运算符,取值说明如下:
- rawvalue:表示直接比较。
- list:表示白名单。
- mod:表示对 100 取模。
- deterministic_proportional_steaming_division:表示百分比。
  • DubboRules 参数说明
参数名称类型示例描述
conditionStringOR灰度规则的条件模式,取值说明如下:
- AND:表示与,即同时满足条件列表中的所有条件。
- OR:表示或,即满足条件列表中的任一条件。
methodNameStringechoDubbo 服务的方法名。
serviceNameStringcom.alibaba.edas.boot.EchoServiceDubbo 服务名称。
versionString1.0.0Dubbo 服务版本。
itemsArray of items条件列表。
groupStringDUBBO灰度规则对应的 Dubbo 服务的分组。

items 参数说明

参数名称类型示例描述
indexInteger0参数编号,0 表示第一个参数。
exprString.name参数值获取表达式。取值说明如下:
- 留空:表示直接取当前参数的值。
- .name:表示取参数的 name 属性,相当于 args0.getName()。
- .isEnabled() :表示取参数的 enabled 属性,相当于 args0.isEnabled()。
- [0]:表示当前参数应是一个数组,取数组的第一个值,相当于 args0[0],注意开始没有英文句点(.)。
- .get(0):表示当前参数应是一个 List,取 List 的第一个值,相当于 args0.get(0)。
- .get("key"):表示当前参数是一个 Map,获取 key 对应的值,相当于 args0.get("key")。
condString==比较操作符。可取值:><>=<===以及!=
valueStringtest参数取值,根据 exprindex 得到的值跟这个值进行比较。
operatorStringrawvalue运算符,取值说明如下:
- rawvalue:表示直接比较。
- list:表示白名单。
- mod:表示对 100 取模。
- deterministic_proportional_steaming_division:表示百分比。

返回参数

字段名称字段详情
RequestIdstring

请求 ID。

示例值:9D29CBD0-45D3-410B-9826-52F86F90****
Messagestring

调用结果的附加信息。

示例值:success
TraceIdstring

调用链 ID,用于精确查询调用信息。

示例值:0a98a02315955564772843261e****
Dataobject

灰度规则信息。

ErrorCodestring

错误码。取值说明如下:展开详情

示例值:
Codestring

接口状态或 POP 错误码。取值说明如下:展开详情

示例值:200
Successboolean

查询变更单信息是否成功。取值说明如下:展开详情

示例值:true
变更历史
变更时间变更内容概要操作
2022-12-29
新增请求参数AlbRules
2021-11-16
变更错误码400