幫助中心
首頁 Virtual Private Cloud 開發參考 API參考 API目錄 路由目標組 ListRouteTargetGroups - 查詢路由目標組列表

ListRouteTargetGroups - 查詢路由目標組列表

更新時間：
Copy as MD
產品

查詢路由目標組列表。

介面說明

查詢路由目標組列表。

調試

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

調試

授權資訊

當前API暫無授權資訊透出。

請求文法

GET  HTTP/1.1

請求參數

名稱

類型

必填

描述

樣本值
VpcId

string

否

路由目標組所屬的 VPC 的 ID。

vpc-xxxx
RouteTargetGroupIds

array

否

路由目標組執行個體 ID 列表。

單次查詢最多支援傳入 50 個執行個體 ID。

string

否

路由目標組執行個體 ID。

rtg-xxxx
MemberId

string

否

路由目標群組成員執行個體 ID。 篩選成員包含傳入成員執行個體 ID 的路由目標組。

ep-xxxx
MaxResults

integer

否

分頁大小，取值範圍：1~50，預設值：50。

50
NextToken

string

否

是否擁有下一次查詢的令牌（Token）。取值：第一次查詢和沒有下一次查詢時，均無需填寫。如果有下一次查詢，取值為上一次 API 呼叫返回的 NextToken 值。

FFmyTO70tTpLG6I3FmYAXGKPd****
RegionId

string

是

路由目標組所屬的 VPC 的地區 ID。您可以通過調用 DescribeRegions 介面擷取地區 ID。

cn-hangzhou
ResourceGroupId

string

否

資源群組 ID。關於資源群組的更多資訊，請參見什麼是資源群組。

rg-acfmxazdjdhd****
ClientToken

string

否

用戶端 Token，用於保證請求的等冪性。從您的用戶端產生一個參數值，確保不同請求間該參數值唯一。ClientToken 只支援 ASCII 字元。說明 若您未指定，則系統自動使用 API 請求的 RequestId 作為 ClientToken 標識。每次 API 請求的 RequestId 不一樣。

123e4567-e89b-12d3-a456-426655440000
Tag

array<object>

否

標籤列表。

object

否

資源的標籤。

Key

string

否

資源的標籤鍵。最多支援輸入 20 個標籤鍵。如需傳入該值，則不能輸入Null 字元串。

一個標籤鍵最多支援 128 個字元，不能以aliyun和acs:開頭，不能包含http://或者https://。

FinanceJoshua
Value

string

否

資源的標籤值。最多支援輸入 20 個標籤值。如需傳入該值，可以輸入Null 字元串。

最多支援 128 個字元，不能以aliyun和acs:開頭，不能包含http://或者https://。

FinanceJoshua

返回參數

名稱

類型

描述

樣本值

object

Schema of Response

RequestId

string

Id of the request

DE77A7F3-3B74-41C0-A5BC-CAFD188C28B6
NextToken

string

是否擁有下一次查詢的令牌（Token）。取值：如果 NextToken 為空白表示沒有下一次查詢。如果 NextToken 有傳回值，該取值表示下一次查詢開始的令牌。

FFmyTO70tTpLG6I3FmYAXGKPd****
TotalCount

integer

列表條目數。

1
RouteTargetGroups

array<object>

路由目標組列表。

array<object>

Status

string

路由目標組的狀態。取值：

  • Recovering：主備回切中

  • Switched：主備已切換

  • Available：可用

  • Abnormal：備執行個體異常

  • Pending：建立中

  • Switching：主備切換中

  • Deleting：刪除中

  • Unavailable：主備執行個體均異常

枚舉值：

  • Recovering :

    主備回切中

  • Switched :

    主備已切換

  • Available :

    可用

  • Abnormal :

    備執行個體異常

  • Pending :

    建立中

  • Switching :

    主備切換中

  • Deleting :

    刪除中

  • Unavailable :

    主備執行個體均異常

Available
RouteTargetGroupDescription

string

路由目標組描述資訊。

myRouteTargetGroupDescription
RouteTargetMemberList

array<object>

路由目標組的成員列表。

object

路由目標組的成員列表。

MemberId

string

路由目標群組成員執行個體 ID。

ep-xxxx
EnableStatus

string

路由目標群組成員使能狀態。取值：

  • Enable：使能中。

  • Disable：未使能。

只有未使能狀態的路由目標群組成員允許被修改為其他執行個體。使能中的路由目標群組成員禁止修改。

枚舉值：

  • Enable :

    Enable

  • Disable :

    Disable

Enable
MemberType

string

路由目標組的成員類型。

當前支援的類型：

  • GatewayLoadBalancerEndpoint

枚舉值：

  • GatewayLoadBalancerEndpoint :

    網關型負載平衡終端節點

GatewayLoadBalancerEndpoint
HealthCheckStatus

string

路由目標群組成員健全狀態檢查狀態。取值：

  • Normal：正常

  • Abnormal：狀態異常

枚舉值：

  • Normal :

    Normal

  • Abnormal :

    Abnormal

Normal
Weight

integer

路由目標群組成員的權重值。取值：

  • 100：表示成員為主執行個體。

  • 0：表示成員為備執行個體。

權重值僅支援在建立時設定，不支援修改。

100
VpcId

string

路由目標組所屬 VPC 的 ID。

vpc-uf60y8uzhsvbhmuh3l654
RouteTargetGroupId

string

路由目標組的執行個體 ID。

rtg-xxxx
ConfigMode

string

路由目標組的配置模式，支援模式如下：

  • Active-Standby: 主備模式。

枚舉值：

  • Active-Standby :

    主備模式

Active-Standby
RegionId

string

路由目標組所屬的 VPC 的地區 ID。

您可以通過調用 DescribeRegions 介面擷取地區 ID。

cn-hangzhou
Tags

array<object>

資源的標籤值。最多支援輸入 20 個標籤值。如需傳入該值，可以輸入Null 字元串。

最多支援 128 個字元，不能以aliyun和acs:開頭，不能包含http://或者https://。

object

資源的標籤。

Value

string

資源的標籤值。最多支援輸入 20 個標籤值。如需傳入該值，可以輸入Null 字元串。

最多支援 128 個字元，不能以aliyun和acs:開頭，不能包含http://或者https://。

8
Key

string

資源的標籤鍵。

image/upload/cbbec42e0be33abb27babefcbe0397f0
RouteTargetGroupName

string

路由目標組名稱資訊。

myRouteTargetGroupName
ResourceGroupId

string

路由目標組所屬的資源群組 ID。

rg-acfm3swh6ta56ri
CreateTime

string

建立路由目標組的時間。

2025-12-30T06:40:50Z
MaxResults

integer

分頁大小。

50

樣本

正常返回樣本

JSON格式

{
  "RequestId": "DE77A7F3-3B74-41C0-A5BC-CAFD188C28B6",
  "NextToken": "FFmyTO70tTpLG6I3FmYAXGKPd****",
  "TotalCount": 1,
  "RouteTargetGroups": [
    {
      "Status": "Available",
      "RouteTargetGroupDescription": "myRouteTargetGroupDescription",
      "RouteTargetMemberList": [
        {
          "MemberId": "ep-xxxx",
          "EnableStatus": "Enable",
          "MemberType": "GatewayLoadBalancerEndpoint",
          "HealthCheckStatus": "Normal",
          "Weight": 100
        }
      ],
      "VpcId": "vpc-uf60y8uzhsvbhmuh3l654",
      "RouteTargetGroupId": "rtg-xxxx",
      "ConfigMode": "Active-Standby",
      "RegionId": "cn-hangzhou",
      "Tags": [
        {
          "Value": "8",
          "Key": "image/upload/cbbec42e0be33abb27babefcbe0397f0"
        }
      ],
      "RouteTargetGroupName": "myRouteTargetGroupName",
      "ResourceGroupId": "rg-acfm3swh6ta56ri",
      "CreateTime": "2025-12-30T06:40:50Z"
    }
  ],
  "MaxResults": 50
}

錯誤碼

HTTP status code

錯誤碼

錯誤資訊

描述
400 IllegalParam.NextToken The specified NextToken is invalid. 參數NextToken非法.

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

變更歷史

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

上一篇：UpdateRouteTargetGroup下一篇：GetRouteTargetGroup - 查詢路由目標組