更新时间:2024-01-29 GMT+08:00

创建灰度发布策略

功能介绍

创建灰度发布策略。

URI

PUT /v3/{project_id}/govern/route-rule/microservices/{service_name}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

租户子项目的唯一标识。字符长度为1~64。

service_name

String

微服务名称。

表2 Query参数

参数

是否必选

参数类型

描述

environment

String

所属环境,不填表示<空>环境。

app_id

String

所属应用,不填默认为default应用。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

String

该字段内容填为 "application/json;charset=UTF-8"。

X-Auth-Token

String

用户Token。

x-engine-id

String

微服务引擎专享版的实例ID。

X-Enterprise-Project-ID

String

企业项目ID。

表4 请求Body参数

参数

是否必选

参数类型

描述

[数组元素]

Array of CreateRules objects

创建灰度发布策略请求结构体。

表5 CreateRules

参数

是否必选

参数类型

描述

precedence

Integer

优先级,数字越大,优先级越高。

match

CreateMatch object

请求匹配规则。0..N个,不配置表示匹配。

route

Array of CreateRoute objects

路由规则列表。

表6 CreateMatch

参数

是否必选

参数类型

描述

headers

headers object

匹配的Headers。

表7 headers

参数

是否必选

参数类型

描述

<header>

<header> object

匹配Header的规则。

表8 <header>

参数

是否必选

参数类型

描述

exact

String

精确匹配值。

caseInsensitive

Boolean

是否区分大小写。

表9 CreateRoute

参数

是否必选

参数类型

描述

name

String

规则名称。

weight

Integer

权重值。

tags

tags object

匹配的实例标记列表。

表10 tags

参数

是否必选

参数类型

描述

<tag>

String

实例标记。满足标记条件的实例放到这一组。

响应参数

状态码: 200

表11 响应Body参数

参数

参数类型

描述

result

String

结果信息。

状态码: 400

表12 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误信息。

detail

String

详细定位信息。

请求示例

PUT https://{endpoint}/v3/{project_id}/govern/route-rule/microservices/{service_name}

[ {
  "precedence" : 1,
  "match" : {
    "headers" : {
      "<header>" : {
        "exact" : "test",
        "caseInsensitive" : false
      }
    }
  },
  "route" : [ {
    "name" : "rule_1",
    "weight" : 20,
    "tags" : {
      "<tag>" : "1.0.0"
    }
  } ]
} ]

响应示例

状态码: 200

创建灰度发布策略响应结构体。

{
  "result" : "string"
}

状态码

状态码

描述

200

创建灰度发布策略响应结构体。

400

错误的请求。

错误码

请参见错误码