CreateOrUpdateSwimmingLane - 创建或更新泳道_Serverless 应用引擎(SAE)-阿里云帮助中心

创建或者更新泳道。

调试

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

授权信息

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

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作
sae:CreateOrUpdateSwimmingLane	create	全部资源 ``	无	无

请求语法

POST /pop/v1/cas/gray/createOrUpdateSwimmingLane HTTP/1.1

请求参数

名称	类型	必填	描述	示例值
LaneId	long	否	泳道 ID。	13857
LaneName	string	否	泳道名称。	test
LaneTag	string	否	泳道标签。	g1
GroupId	long	否	所属泳道组 ID。	b2a8a925-477a-eswa-b823-d5e22500****
NamespaceId	string	否	命名空间 ID。	cn-beijing:test
CanaryModel	integer	否	全链路灰度模式： 0: 按请求内容路由 1: 按比例路由	0
Enable	boolean	否	泳道状态： true：开启 false：关闭	true
AppEntryRule	object	否	网关路由配置。说明泳道组网关入口为 Java 时，此字段为必填项。
Paths	array	否	匹配的请求路径。
	string	否	请求路径。	/A
Percentage	integer	否	流量比例，按比例路由使用，取值 0-100。	50
ConditionJoiner	string	否	条件之间的逻辑连接符： AND：同时满足所有条件 OR：满足任意条件	AND
Conditions	array<object>	否	匹配条件。
	object	否	条件项。
Type	string	否	参数类型： header：Header param：Parameter cookie：Cookie	Header
Name	string	否	参数名称。	t
Condition	string	否	匹配规则： ==：精确匹配，流量值与条件值需要完全相等。 !=：精确匹配，流量值与条件值需要完全相等。 in：包含匹配，流量值需要在指定的列表中时满足条件。百分比：百分比匹配，原理：满足`hash(get(key)) % 100 < value` 成立时满足条件。正则匹配：正则表达式匹配，按照正则表达式规则匹配时满足条件。	==
Value	string	否	条件的匹配值。	g1
IndependentPercentageEnable	boolean	否	是否启用按比例灰度。 true：启用，启用后需要配置 PercentageByPath。 false：不启用。	true
PercentageByPath	object	否	流量配置。
	integer	否	为所配置的路径配置流量比例，范围为 1~100。	50
MseGatewayEntryRule	object	否	MSE 网关路由配置。说明当 EntryAppType 配置为 apig 或mse-gw时，为必填字段。
RouteIds	array	否	路由 ID。
	long	否	网关路由 ID。调用 ListGatewayRoute 获取。	78830
Percentage	integer	否	流量复制比例（%），取值 0-100。	100
ConditionJoiner	string	否	条件之间的逻辑连接符： AND：同时满足所有条件 OR：满足任意条件	AND
Conditions	array<object>	否	路由条件。
	object	否	配置路由条件。
Type	string	否	参数类型： header：Header param：Parameter cookie：Cookie	header
Name	string	否	条件参数名称。	test
Condition	string	否	匹配规则。 ==：精确匹配。 !=：精确匹配。 in：包含匹配。百分比：百分比匹配。正则匹配：正则表达式匹配。	==
Value	string	否	条件的匹配值。	g1
IndependentPercentageEnable	boolean	否	是否启用按比例灰度。 true：启用，启用后需要配置 PercentageByPath。 false：不启用。	true
PercentageByRoute	object	否	流量配置。
	integer	否	配置流量比例，范围为 1~100。	100

返回参数

名称	类型	描述	示例值
	object	创建或更新的泳道结果。
RequestId	string	请求 ID。	91F93257-7A4A-4BD3-9A7E-2F6EAE6D****
Message	string	附加信息。取值说明如下：请求正常，返回 success。请求异常，返回具体异常错误码。	success
TraceId	string	调用链 ID，用于精确查询调用信息。	0a98a02315955564772843261e****
Data	object	返回信息。
LaneId	long	泳道 ID。	22318
ErrorCode	string	错误码。取值说明如下：请求成功：不返回 ErrorCode 字段。请求失败：返回 ErrorCode 字段。具体信息，请参见本文的错误码列表。	空
Code	string	接口状态或 POP 错误码。取值说明如下： 2xx：成功。 3xx：重定向。 4xx：请求错误。 5xx：服务器错误。	200
Success	boolean	是否成功创建或更新。取值说明如下： true：创建成功 false：创建失败	true

示例

正常返回示例

JSON格式

{
  "RequestId": "91F93257-7A4A-4BD3-9A7E-2F6EAE6D****",
  "Message": "success",
  "TraceId": "0a98a02315955564772843261e****",
  "Data": {
    "LaneId": 22318
  },
  "ErrorCode": "空",
  "Code": 200,
  "Success": true
}

错误码

HTTP status code	错误码	错误信息	描述
400	InvalidParameter.NotEmpty	You must specify the parameter %s.	不合法的参数：%s不能为空。
400	InvalidParameter.Obviously	The specified parameter is invalid {%s}.	不合法的参数{%s}。
400	InvalidParameter.WithMessage	The parameter is invalid {%s}: %s	不合法的参数{%s}：%s。
400	MseGatewayRule.CreateFailed	Create MSE Gateway rule failed.	创建MSE微服务网关路由失败。
400	InternalApiError	An exception occurred when calling mse:%s, error message: %s.	调用 mse:%s 接口异常，%s

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