文档

InsertSwimmingLane - 新建泳道

新建泳道。

调试

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

调试

授权信息

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

请求语法

POST /pop/v5/trafficmgnt/swimming_lanes

请求参数

名称类型必填描述示例值
LogicalRegionIdstring

自定义命名空间的 RegionId。 格式为:物理 Region:自定义命名空间标识符,例如cn-hangzhou:test

cn-beijing:test
Namestring

泳道名称。

test1
Tagstring

标签。

tag
GroupIdlong

泳道组 ID。

95
EntryRulesstring

流控条件。

[{"priority":1,"path":"/traffic","condition":"AND","restItems":[{"type":"header","name":"testheader","value":"testvalue","cond":"==","operator":"rawvalue"}]}]
EnableRulesboolean

是否启用流控规则。

true
AppInfosstring

泳道涉及应用信息。

[{"appId":"f72deaac-26ba-429a-948d-5fa47c4a****"},{"appId":"5049d2c8-f997-4fc9-92a2-153506a6****"}]

返回参数

名称类型描述示例值
object

返回对象。

Codeinteger

状态码。

200
Messagestring

附加信息。

success
RequestIdstring

请求 ID。

75972A87-5682-5277-ADA7-DA2A01BE****
Dataobject

返回数据。

NamespaceIdstring

命名空间 ID。

cn-beijing:test
GroupIdlong

泳道组 ID。

95
EntryRulestring

泳道流控规则。

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\"}]}]
AppInfosstring

泳道关联应用列表。

[{"appId":"9dcba109-ee9f-4e67-8916-41 *******"}]
Tagstring

流控泳道标签。

8202e09
Namestring

泳道名称。

test1
Idlong

泳道 ID。

88
SwimmingLaneAppRelationShipListobject []

泳道涉及应用关联关系列表。

AppNamestring

应用名称。

test-app
Rulesstring

关联规则。

dubbo
LaneIdlong

泳道 ID。

88
AppIdstring

应用 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错误码错误信息描述
605Edas.errorcode.ParameterInvalid.PointedParameter.messageThe value of parameter {0} is invalid.无效输入参数:{0}

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

  • 本页导读 (1)
文档反馈