全部產品
Search

搜尋本產品

    Alibaba Cloud Service Mesh：GetSwimLaneGroupList - 擷取網格執行個體下所有泳道組列表

    文件中心

    Alibaba Cloud Service Mesh：GetSwimLaneGroupList - 擷取網格執行個體下所有泳道組列表

    更新時間：Feb 06, 2026

    調用GetSwimLaneGroupList擷取網格執行個體下所有泳道組列表。

    介面說明

    調用 DescribeASMSidecarExpectedVersion 可以查詢 ASM 資料面 Sidecar 的期望版本，例如升級 ASM 之前，注入 Sidecar 的版本為 v1.11，然後升級 ASM 到 v1.12，Pod 沒有重啟，Sidecar 的實際版本仍然為 v1.11，但是調用 DescribeASMSidecarExpectedVersion 這個介面將查詢到 Sidecar 版本是 v1.12。

    調試

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

    調試

    授權資訊

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

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

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    servicemesh:GetSwimLaneGroupList

    get

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    ServiceMeshId

    string

    是

    服務網格 ID。

    xxxx

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    RequestId

    string

    請求 ID。

    yyyy
    SwimLaneGroupList

    array<object>

    泳道組資訊列表

    object

    單個泳道組資訊

    GroupName

    string

    泳道組名稱。

    test
    ServiceList

    string

    泳道組關聯的服務列表。

    ["sh01/c089443ea9e50403fa4f0a6237d11e0a9/default/mocka","sh01/c089443ea9e50403fa4f0a6237d11e0a9/default/mockb","sh01/c089443ea9e50403fa4f0a6237d11e0a9/default/mockc"]
    IngressType

    string

    引流規則目前僅支援在 ASM 網關下進行配置。

    ASM
    IngressGatewayName

    string

    ASM 網關名稱。

    ingressgateway
    IsPermissive

    boolean

    流量泳道組是否是寬鬆模式。

    false
    FallbackTarget

    string

    寬鬆模式泳道組的基準泳道名稱。僅在泳道組為寬鬆模式時，設定此參數有效。

    s1
    TraceHeader

    string

    寬鬆模式泳道組的鏈路透傳要求標頭。

    my-request-id
    RouteHeader

    string

    寬鬆模式流量泳道組的引流要求標頭。

    x-asm-prefer-tag
    SwimLaneLabels

    string

    一個序列化後的 JSON 字串，其中 JSON 對象的鍵為泳道組中所有服務都擁有的標籤的鍵，JSON 對象的值為該標籤下泳道組內服務的所有可能的標籤值數組。

    {"ASM_TRAFFIC_TAG":["v2","v3","v1"],"version":["v3","v1","v2"]}
    IngressRoutingStrategy

    string

    為泳道組內的多個泳道進行請求引流的策略，有兩種可能取值：

    • weighted：基於權重的引流策略，即首先以統一的規則對請求進行匹配，對匹配到的請求進行引流，引流時，按照給定的比例將所有請求發往不同的泳道。

    • rule-based：基於規則的引流策略，即泳道組中的每條泳道都擁有自己的匹配規則，只有匹配到泳道對應的引流規則的請求才會被轉寄到對應的泳道。

    枚舉值：

    • weighted :

      weighted

    • rule-based :

      rule-based

    weighted
    WeightedIngressRule

    string

    當泳道組的引流策略為 weighted 時可以設定。作用於整個泳道組的引流規則，

    {"Domains":["*"],"MatchRequests":[{"URI":{"MatchingMode":"exact","MatchingContent":"/mock"},"Headers":[{"Name":"test","MatchingMode":"exact","MatchingContent":"yes"}]}]}
    ServiceLevelFallbackTarget

    string

    服務等級 fallback 目標，為服務分別指定需要 fallback 的版本，這將覆蓋泳道層級的 fallback 策略。

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "yyyy",
  "SwimLaneGroupList": [
    {
      "GroupName": "test",
      "ServiceList": "[\"sh01/c089443ea9e50403fa4f0a6237d11e0a9/default/mocka\",\"sh01/c089443ea9e50403fa4f0a6237d11e0a9/default/mockb\",\"sh01/c089443ea9e50403fa4f0a6237d11e0a9/default/mockc\"]",
      "IngressType": "ASM",
      "IngressGatewayName": "ingressgateway",
      "IsPermissive": false,
      "FallbackTarget": "s1",
      "TraceHeader": "my-request-id",
      "RouteHeader": "x-asm-prefer-tag",
      "SwimLaneLabels": "{\"ASM_TRAFFIC_TAG\":[\"v2\",\"v3\",\"v1\"],\"version\":[\"v3\",\"v1\",\"v2\"]}",
      "IngressRoutingStrategy": "weighted",
      "WeightedIngressRule": "{\"Domains\":[\"*\"],\"MatchRequests\":[{\"URI\":{\"MatchingMode\":\"exact\",\"MatchingContent\":\"/mock\"},\"Headers\":[{\"Name\":\"test\",\"MatchingMode\":\"exact\",\"MatchingContent\":\"yes\"}]}]}",
      "ServiceLevelFallbackTarget": ""
    }
  ]
}

    錯誤碼

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

    變更歷史

    更多資訊，參考變更詳情。