全部產品
Search

搜尋本產品

    Server Load Balancer：ListServerGroupServers - 查詢服務器組中的伺服器列表

    文件中心

    Server Load Balancer：ListServerGroupServers - 查詢服務器組中的伺服器列表

    更新時間：Aug 06, 2025

    查詢負載平衡伺服器組中的伺服器列表。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    gwlb:ListServerGroupServers

    get

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    ServerGroupId

    string

    否

    伺服器組 ID。

    sgp-atstuj3rtoptyui****
    ServerIds

    array

    否

    伺服器 ID 列表。

    單次調用最多支援展示 200 個伺服器。

    string

    否

    伺服器 ID。

    • 當伺服器組為 Instance 類型時，該參數為 Ecs、Eni、Eci 的資源 ID。

    • 當伺服器組為 Ip 類型時，該參數為 IP 位址。

    i-bp67acfmxazb4p****
    ServerIps

    array

    否

    伺服器 IP 位址列表。

    單次調用最多支援展示 200 個伺服器。

    string

    否

    伺服器 IP 位址。

    192.168.xxx.xxx
    NextToken

    string

    否

    是否擁有下一次查詢的令牌（Token）。取值：

    • 如果 NextToken 為空白表示沒有下一次查詢。

    • 如果 NextToken 有傳回值，該取值表示下一次查詢開始的令牌。

    FFmyTO70tTpLG6I3FmYAXGKPd****
    MaxResults

    integer

    否

    分批次查詢時每次顯示的條目數。

    取值範圍：1~1000。

    預設值：20。

    20
    Skip

    integer

    否

    查詢時跳過指定的條目數。

    1

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    返回資料結構體。

    MaxResults

    integer

    分批次查詢時每次顯示的條目數。

    取值範圍：1~1000。

    20
    NextToken

    string

    是否擁有下一次查詢的令牌（Token）。取值：

    • 第一次查詢和沒有下一次查詢時，均無需填寫。

    • 如果有下一次查詢，取值為上一次 API 呼叫返回的 NextToken 值。

    FFmyTO70tTpLG6I3FmYAXGKPd****
    RequestId

    string

    請求 ID。

    54B48E3D-DF70-471B-AA93-08E683A1B45
    Servers

    array<object>

    後端伺服器列表。

    object

    後端伺服器。

    Port

    integer

    後端伺服器使用的連接埠，取值：

    • 6081。

    6081
    ServerGroupId

    string

    伺服器組 ID。

    sgp-atstuj3rtoptyui****
    ServerId

    string

    後端伺服器 ID。

    i-bp67acfmxazb4p****
    ServerIp

    string

    後端伺服器 IP 位址。

    192.168.xxx.xxx
    ServerType

    string

    後端伺服器類型，取值：

    • Ecs：ECS 執行個體。

    • Eni：ENI 彈性網卡執行個體。

    • Eci：ECI 彈性容器。

    • Ip：Ip 地址。

    Ecs
    Status

    string

    後端伺服器的狀態。取值：

    • Adding：添加中。

    • Available：正常可用狀態。

    • Draining：串連優雅中斷中。

    • Removing：移除中。

    • Replacing：替換中。

    Available
    TotalCount

    integer

    列表條目數。

    1

    樣本

    正常返回樣本

    JSON格式

    {
  "MaxResults": 20,
  "NextToken": "FFmyTO70tTpLG6I3FmYAXGKPd****",
  "RequestId": "54B48E3D-DF70-471B-AA93-08E683A1B45",
  "Servers": [
    {
      "Port": 6081,
      "ServerGroupId": "sgp-atstuj3rtoptyui****",
      "ServerId": "i-bp67acfmxazb4p****",
      "ServerIp": "192.168.xxx.xxx",
      "ServerType": "Ecs",
      "Status": "Available"
    }
  ],
  "TotalCount": 1
}

    錯誤碼

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

    變更歷史

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