修改标签路由规则
更新时间 2025-09-11 14:29:00
最近更新时间: 2025-09-11 14:29:00
接口功能介绍
调用updateTagRule接口修改标签路由规则
接口约束
无
URI
POST /msgc/v1/tag/updateRule
路径参数 无
Query参数 无
请求参数
请求头header参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| regionId | 是 | String | 资源池ID | bb9fdb42056f11eda161xxxxxxxxx | |
| msnamespace | 是 | String | 环境参数 | default |
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| appId | 是 | String | 应用唯一id | 723df9e5e575bf9e91f4e1axxxxxx | |
| carryData | 是 | Boolean | 是否链路传递 true是 false否 | true | |
| percent | 是 | Boolean | 是否开启规则 true 是 false 否 | true | |
| ruleName | 是 | String | 规则名称 | Gray-rule | |
| rules | 是 | Array of Objects | 规则列表 | rules | |
| tag | 是 | String | 标签名称 | 标签名称 | |
| 表 rules |
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| condition | 是 | String | 规则条件ADD/OR | AND | |
| conditions | 是 | Array of Objects | 规则条件列表 | conditions | |
| group | 否 | String | 配置dubbo规则时，dubbo接口的分组 | group1 | |
| version | 否 | String | 配置dubbo规则时，dubbo接口的版本 | 1.0.0 | |
| path | 是 | String | 接口路径 | /test/testRule | |
| serviceType | 是 | String | 框架类型 | SpringCloud | |
| paramTypes | 否 | String | 类型，当框架为Dubbo时需要填写 | java.lang.String,java.lang.String | |
| serviceName | 否 | String | 服务名，当框架为Dubbo时需要填写 | com.test.TestService | |
| methodName | 否 | String | 方法，当框架为Dubbo时需要填写 | test | |
| 表 conditions |
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| type | 是 | String | 类型 cookie/header/param/body，当框架为SpringCloud时需要填写 | cookie | |
| param | 是 | String | 参数名，当框架为SpringCloud时需要填写 | tag | |
| cond | 是 | String | 条件=、!=、>、<、>=、<=、in、%（百分比）、regexp（正则）、mod（模100） | = | |
| value | 是 | String | 参数值 | gray | |
| operator | 否 | String | cond为mod时，operator赋值=、!=、>、<、>=、<= | = | |
| expr | 否 | String | 使用Dubbo框架时，expr代表参数获取表达式 | .name | |
| index | 否 | Integer | 使用Dubbo框架时，index代表取得是第几个参数 | 0 |
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| statusCode | Integer | 响应编码 2000 success | 2000 | |
| returnObj | Object | 空对象 | ||
| message | String | 消息内容 | success |
枚举参数
无
请求示例
请求url
https://{endpoint}/msgc/v1/tag/updateRule
请求头header
{
"regionId":"bb9fdb42056f11eda161xxxxxxxxx",
"msnamespace":"default"
}
请求体body
{
"ruleName":"Gray-rule",
"appId":"723df9e5e575bf9e91f4e1axxxxxx",
"tag":"gray",
"carryData":false,
"percent":true,
"rules":[
{
"serviceType":"SpringCloud",
"condition":"AND",
"group":"",
"version":"",
"path":"/test/testRule",
"conditions":[
{
"type":"cookie",
"param":"132",
"cond":"=",
"value":"123"
}
]
}
]
}
响应示例
{"statusCode":2000,"message":"success","returnObj":{}}
状态码
请参考 状态码
错误码
请参考 错误码
