すべてのプロダクト
Search

このプロダクト

    Alibaba Cloud Service Mesh:GetSwimLaneList

    ドキュメントセンター

    Alibaba Cloud Service Mesh:GetSwimLaneList

    最終更新日:Nov 24, 2025

    GetSwimLaneList を呼び出して、スイムレーングループ内のすべてのスイムレーンのリストを取得します。

    今すぐお試しください

    この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    servicemesh:GetSwimLaneList

    get

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    ServiceMeshId

    string

    必須

    Service Mesh インスタンス ID。

    xxx
    GroupName

    string

    任意

    スイムレーングループの名前。

    test

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    RequestId

    string

    リクエスト ID。

    yyyy
    SwimLaneList

    array<object>

    スイムレーンのリスト。

    object

    スイムレーンに関する情報。

    Name

    string

    スイムレーンの名前。

    s1
    GroupName

    string

    スイムレーングループの名前。

    test
    LabelSelectorKey

    string

    関連付けられたサービスワークロードのラベルキー。値は ASM_TRAFFIC_TAG に固定されています。

    ASM_TRAFFIC_TAG
    LabelSelectorValue

    string

    ASM_TRAFFIC_TAG ラベルの値。

    v1
    IngressService

    string

    このパラメーターは非推奨です。

    mocka.default.svc.cluster.local
    IngressRule

    string

    トラフィックルーティングルール。

    [{"Domains":["*"],"RouteName":"r1","MatchRequest":{"Headers":[{"Name":"x-asm-prefer-tag","MatchingMode":"exact","MatchingContent":"s1"}],"URI":{"MatchingMode":"exact","MatchingContent":"/mock"}},"RouteDestinations":[{"Destination":{"Host":"mocka.default.svc.cluster.local","Subset":"s1"}}]},{"Domains":["*"],"RouteName":"hello","MatchRequest":{"Headers":[{"Name":"x-asm-prefer-tag","MatchingMode":"exact","MatchingContent":"s1"}],"URI":{"MatchingMode":"exact","MatchingContent":"/mocktest"}},"RouteDestinations":[{"Destination":{"Host":"mocka.default.svc.cluster.local","Subset":"s1"}}]}]
    ServiceList

    string

    関連付けられたサービスのリスト。

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

    string

    このパラメーターは、スイムレーングループのトラフィックルーティングポリシーが `weighted` の場合に利用できます。値は、スイムレーンの Ingress サービスドメイン名とトラフィックの重みを指定する JSON シリアル化された文字列です。

    {"RouteDestination":{"Host":"mocka.default.svc.cluster.local","Subset":"s1"},"Weight":40}
    ValidationMessage

    string

    スイムレーンの検証メッセージのリスト。スイムレーングループ内のサービスが存在しないなどの問題が発生した場合、このリストに対応する検証情報が表示されます。構成が成功して有効になると、`null` が返されます。

    [{"code":"CODE_UNEFFECTED_SWIMLANE_LABEL","level":"warning","message":"The label selector defined in the ASMSwimLane has no effect on any workload instance."}]

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "yyyy",
  "SwimLaneList": [
    {
      "Name": "s1",
      "GroupName": "test",
      "LabelSelectorKey": "ASM_TRAFFIC_TAG",
      "LabelSelectorValue": "v1",
      "IngressService": "mocka.default.svc.cluster.local",
      "IngressRule": "[{\"Domains\":[\"*\"],\"RouteName\":\"r1\",\"MatchRequest\":{\"Headers\":[{\"Name\":\"x-asm-prefer-tag\",\"MatchingMode\":\"exact\",\"MatchingContent\":\"s1\"}],\"URI\":{\"MatchingMode\":\"exact\",\"MatchingContent\":\"/mock\"}},\"RouteDestinations\":[{\"Destination\":{\"Host\":\"mocka.default.svc.cluster.local\",\"Subset\":\"s1\"}}]},{\"Domains\":[\"*\"],\"RouteName\":\"hello\",\"MatchRequest\":{\"Headers\":[{\"Name\":\"x-asm-prefer-tag\",\"MatchingMode\":\"exact\",\"MatchingContent\":\"s1\"}],\"URI\":{\"MatchingMode\":\"exact\",\"MatchingContent\":\"/mocktest\"}},\"RouteDestinations\":[{\"Destination\":{\"Host\":\"mocka.default.svc.cluster.local\",\"Subset\":\"s1\"}}]}]",
      "ServiceList": "[\"sh01/c089443ea9e50403fa4f0a6237d11e0a9/default/mocka\",\"sh01/c089443ea9e50403fa4f0a6237d11e0a9/default/mockb\",\"sh01/c089443ea9e50403fa4f0a6237d11e0a9/default/mockc\"]",
      "WeightedIngressDestinatin": "{\"RouteDestination\":{\"Host\":\"mocka.default.svc.cluster.local\",\"Subset\":\"s1\"},\"Weight\":40}",
      "ValidationMessage": "[{\"code\":\"CODE_UNEFFECTED_SWIMLANE_LABEL\",\"level\":\"warning\",\"message\":\"The label selector defined in the ASMSwimLane has no effect on any workload instance.\"}]"
    }
  ]
}

    エラーコード

    完全なリストについては、「エラーコード」をご参照ください。

    変更履歴

    完全なリストについては、「変更履歴」をご参照ください。