UpdateGreyTagRoute_Serverless 应用引擎_API文档

插件下载了解更多
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.

流控信息

当前云产品API请求速率暂未透出。

授权信息

如下是此API对应的授权信息,用于RAM权限策略语句的Action元素中,为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置,使用方法可参考访问控制帮助文档

具体说明如下:展开详情

操作访问级别资源类型条件关键字关联操作
sae:UpdateGreyTagRoute
Update
全部资源
*

请求语法

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

返回示例

错误码

全局错误码
HTTP 状态码错误码错误信息操作
400
InvalidParameter.NotEmpty
You must specify the parameter %s.诊断
400
InvalidParameter.Obviously
The specified parameter is invalid {%s}.诊断
400
InvalidParameter.WithMessage
The parameter is invalid {%s}: %s诊断
400
Application.ChangerOrderRunning
An application change process is in progress. Please try again later.诊断

变更历史

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

相关示例