全部產品
Search
文件中心

Microservices Engine:QueryAllSwimmingLane - 查詢當前泳道組內所有泳道

更新時間:Aug 05, 2025

擷取所有泳道資訊

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊,可以在RAM權限原則語句的Action元素中使用,用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下:

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

mse:QueryAllSwimmingLane

get

*GovernanceNamespace

acs:mse:{#regionId}:{#accountId}:namespace/{#Namespace}

請求參數

名稱

類型

必填

描述

樣本值

Namespace

string

MSE 命名空間名字

default

GroupId

integer

泳道組 ID

186

AcceptLanguage

string

返回資訊的語言類型:

  • zh:中文

  • en:英文

zh

返回參數

名稱

類型

描述

樣本值

object

RestResult

RequestId

string

請求 ID。

DC34E4A3-5F1C-4E40-86EA-02EDF967****

Success

boolean

請求結果,取值如下:

  • true:請求成功。

  • false:請求失敗。

true

ErrorCode

string

錯誤碼。

Success

Message

string

返回資訊。

OK

Data

array<object>

資料概覽。

[{id:100,name:"test"}]

object

Name

string

泳道組名稱。

swimmingGroup

UserId

string

泳道所屬的使用者 id。

12345

MessageQueueFilterSide

string

在哪一側實現訊息灰階。

Client

Enable

string

是否開啟。

true

Namespace

string

泳道所屬的 MSE 命名空間。

default

RecordCanaryDetail

boolean

是否記錄請求詳情(全鏈路灰階可觀測)。

false

Id

integer

泳道 Id。

123

RegionId

string

所屬地區。

cn-hangzhou

MessageQueueGrayEnable

boolean

是否開啟訊息灰階。

false

enableRules

boolean

是否開啟規則。

true

EntryRules

array<object>

入口應用規則列表

object

入口應用規則

paths

array

路徑列表

string

路徑

/

path

string

路徑

/adump/wxb/prod

condition

string

條件

AND

restItems

array<object>

Rest 匹配規則列表

object

Rest 匹配規則

type

string

匹配類型

cookie

name

string

名稱

test

operator

string

操作符

rawvalue

nameList

array

匹配列表

string

匹配名稱

test

datum

string

數值

x

cond

string

匹配符

==

divisor

integer

除數

10

remainder

integer

餘數

10

rate

integer

百分比

30

value

string

test

gmtCreate

string

泳道建立時間。

1683598484000

gmtModified

string

泳道更新時間。

1683598484000

groupId

string

泳道組 Id。

72709

GroupId

string

泳道組 Id。

6859

tag

string

泳道對應的標籤。

gray

Tag

string

泳道對應的標籤。

gray

GatewaySwimmingLaneRoute

object

網關路由資訊(使用雲原生網關/APIG 網關為入口時使用)

GatewayId

integer

網關 ID

1

GatewayUniqueId

string

網關唯一 ID

gw-84efde2ee1464260bdb17a5b****

RouteIdList

array

路由 ID 列表,網關層級生效可不填

integer

路由 ID

1

CanaryModel

integer

全鏈路灰階模式:

  • 0: 按請求內容路由

  • 1: 按比例路由

0

Conditions

array<object>

匹配條件列表(按內容路由使用)

object

匹配條件

Name

string

參數名稱

name

Value

string

參數值

xiaoming

Type

string

參數類型:

  • header:Header

  • param:Parameter

header

Cond

string

條件:

  • PRE:首碼匹配

  • EQUAL:精確匹配

  • ERGULAR:正則匹配

PRE

NameList

array

NameList

string

Name

name

Percentage

integer

流量比例(按比例路由使用,取值 0-100)

20

RouteIndependentPercentageEnable

string

是否獨立設定每條路徑的百分比

true

RouteIndependentPercentageList

array<object>

路由與百分比列表

object

RouteId

string

路由 id

12345

Percentage

string

百分比

60

Condition

string

灰階條件

AND、OR

PathIndependentPercentageEnable

boolean

是否設定每條路徑的百分比

true

GatewaySwimmingLaneRouteJson

string

網關相關資訊(MSE 雲原生網關/雲原生 API Gateway作為入口時使用)

{\"GatewayUniqueId\":\"gw-cf815503e0a8441b8956d8e349fa8fb5\",\"Percentage\":0,\"RouteIdList\":[32295,32298,32297,32309,32307,32294,32303,32292,32299,35278],\"CanaryModel\":1,\"Conditions\":[]}

樣本

正常返回樣本

JSON格式

{
  "RequestId": "DC34E4A3-5F1C-4E40-86EA-02EDF967****",
  "Success": true,
  "ErrorCode": "Success",
  "Message": "OK",
  "Data": [
    {
      "Name": "swimmingGroup",
      "UserId": "12345",
      "MessageQueueFilterSide": "Client",
      "Enable": "true",
      "Namespace": "default",
      "RecordCanaryDetail": false,
      "Id": 123,
      "RegionId": "cn-hangzhou",
      "MessageQueueGrayEnable": false,
      "enableRules": true,
      "EntryRules": [
        {
          "paths": [
            "/"
          ],
          "path": "/adump/wxb/prod",
          "condition": "AND",
          "restItems": [
            {
              "type": "cookie",
              "name": "test",
              "operator": "rawvalue",
              "nameList": [
                "test"
              ],
              "datum": "x",
              "cond": "==",
              "divisor": 10,
              "remainder": 10,
              "rate": 30,
              "value": "test"
            }
          ]
        }
      ],
      "gmtCreate": "1683598484000",
      "gmtModified": "1683598484000",
      "groupId": "72709",
      "GroupId": "6859",
      "tag": "gray",
      "Tag": "gray",
      "GatewaySwimmingLaneRoute": {
        "GatewayId": 1,
        "GatewayUniqueId": "gw-84efde2ee1464260bdb17a5b****",
        "RouteIdList": [
          1
        ],
        "CanaryModel": 0,
        "Conditions": [
          {
            "Name": "name",
            "Value": "xiaoming",
            "Type": "header",
            "Cond": "PRE",
            "NameList": [
              "name"
            ]
          }
        ],
        "Percentage": 20,
        "RouteIndependentPercentageEnable": "true",
        "RouteIndependentPercentageList": [
          {
            "RouteId": "12345",
            "Percentage": "60"
          }
        ],
        "Condition": "AND、OR"
      },
      "PathIndependentPercentageEnable": true,
      "GatewaySwimmingLaneRouteJson": "{\\\"GatewayUniqueId\\\":\\\"gw-cf815503e0a8441b8956d8e349fa8fb5\\\",\\\"Percentage\\\":0,\\\"RouteIdList\\\":[32295,32298,32297,32309,32307,32294,32303,32292,32299,35278],\\\"CanaryModel\\\":1,\\\"Conditions\\\":[]}"
    }
  ]
}

錯誤碼

HTTP status code

錯誤碼

錯誤資訊

描述

400 IllegalRequest Invalid request:%s 非法請求: %s
400 InvalidParameter Parameter error:%s 請求參數錯誤:%s
500 InternalError Console error. Try again later:%s 控制台錯誤.稍後重試:%s
403 NoPermission You are not authorized to perform this operation:%s 沒有許可權使用此介面:%s
404 NotFound Not found:%s 資源不存在:%s

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情