调用InsertSwimmingLane接口新建泳道_企业级分布式应用服务(EDAS)-阿里云帮助中心

新建泳道。

调试

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

调试

授权信息

当前API暂无授权信息透出。

请求语法

POST /pop/v5/trafficmgnt/swimming_lanes

请求参数

名称	类型	必填	描述	示例值

名称	类型	必填	描述	示例值
LogicalRegionId	string	是	自定义命名空间的 RegionId。格式为：`物理 Region:自定义命名空间标识符`，例如`cn-hangzhou:test`。	cn-beijing:test
Name	string	是	泳道名称。	test1
Tag	string	是	标签。	tag
GroupId	long	是	泳道组 ID。	95
EntryRules	string	是	流控条件。	[{"priority":1,"path":"/traffic","condition":"AND","restItems":[{"type":"header","name":"testheader","value":"testvalue","cond":"==","operator":"rawvalue"}]}]
EnableRules	boolean	否	是否启用流控规则。	true
AppInfos	string	否	泳道涉及应用信息。	[{"appId":"f72deaac-26ba-429a-948d-5fa47c4a**"},{"appId":"5049d2c8-f997-4fc9-92a2-153506a6**"}]

返回参数

名称	类型	描述	示例值

名称	类型	描述	示例值
	object	返回对象。
Code	integer	状态码。	200
Message	string	附加信息。	success
RequestId	string	请求 ID。	75972A87-5682-5277-ADA7-DA2A01BE****
Data	object	返回数据。
NamespaceId	string	命名空间 ID。	cn-beijing:test
GroupId	long	泳道组 ID。	95
EntryRule	string	泳道流控规则。 priority：泳道规则优先级，取值范围：1～100。 path：泳道规则匹配的路径。 restItems：条件匹配规则列表。 condition：条件匹配类型。 AND：同时满足条件。 OR：满足任一条件。 restItems.type：规则类型。可选值范围： header：按请求 Header 进行匹配。 cookie：按请求 cookie 进行匹配。 param：按请求参数进行匹配。 restItems.name：规则匹配的键。 restItems.value：规则匹配的值。 restItems.cond：规则匹配的条件。可取值范围： "=="：等于。 "!="：不等于。 ">"：大于。 "<"：小于。 ">="：大于等于。 "<="：小于等于。 "in"：在可选值内。 restItems.operator：值的类型。可取值范围： rawvalue：取原值。 mod：取模。 list：列表取值。	[{\"condition\":\"AND\",\"enable\":false,\"path\":\"/traffic\",\"priority\":1,\"restItems\":[{\"cond\":\"==\",\"datum\":\"testvalue\",\"name\":\"testheader\",\"operator\":\"rawvalue\",\"type\":\"header\",\"value\":\"testvalue\"}]}]
AppInfos	string	泳道关联应用列表。	[{"appId":"9dcba109-ee9f-4e67-8916-41 *******"}]
Tag	string	流控泳道标签。	8202e09
Name	string	泳道名称。	test1
Id	long	泳道 ID。	88
SwimmingLaneAppRelationShipList	object []	泳道涉及应用关联关系列表。
AppName	string	应用名称。	test-app
Rules	string	关联规则。	dubbo
LaneId	long	泳道 ID。	88
AppId	string	应用 ID。	bd170895-096c-4944-9007-d4582c77****

示例

正常返回示例

JSON格式

        

          
      
        
{
  "Code": 200,
  "Message": "success",
  "RequestId": "75972A87-5682-5277-ADA7-DA2A01BE****",
  "Data": {
    "NamespaceId": "cn-beijing:test",
    "GroupId": 95,
    "EntryRule": "[{\\\"condition\\\":\\\"AND\\\",\\\"enable\\\":false,\\\"path\\\":\\\"/traffic\\\",\\\"priority\\\":1,\\\"restItems\\\":[{\\\"cond\\\":\\\"==\\\",\\\"datum\\\":\\\"testvalue\\\",\\\"name\\\":\\\"testheader\\\",\\\"operator\\\":\\\"rawvalue\\\",\\\"type\\\":\\\"header\\\",\\\"value\\\":\\\"testvalue\\\"}]}]",
    "AppInfos": "[{\"appId\":\"9dcba109-ee9f-4e67-8916-41\n*******\"}]",
    "Tag": "8202e09",
    "Name": "test1",
    "Id": 88,
    "SwimmingLaneAppRelationShipList": [
      {
        "AppName": "test-app",
        "Rules": "dubbo",
        "LaneId": 88,
        "AppId": "bd170895-096c-4944-9007-d4582c77****"
      }
    ]
  }
}

错误码

HTTP status code	错误码	错误信息	描述

HTTP status code	错误码	错误信息	描述
605	Edas.errorcode.ParameterInvalid.PointedParameter.message	The value of parameter {0} is invalid.	无效输入参数：{0}

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