全部產品
Search
文件中心

Server Load Balancer:GetLoadBalancerAttribute - 查詢Server Load Balancer執行個體詳細資料

更新時間:Dec 21, 2025

查詢Server Load Balancer執行個體詳細資料。

調試

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

調試

授權資訊

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

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

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

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

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

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

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

gwlb:GetLoadBalancerAttribute

get

*LoadBalancer

acs:gwlb:{#regionId}:{#accountId}:loadbalancer/{#LoadBalancerId}

請求參數

名稱

類型

必填

描述

樣本值

LoadBalancerId

string

網關型Server Load Balancer執行個體的 ID

gwlb-9njtjmqt7zfcqm****

返回參數

名稱

類型

描述

樣本值

object

AddressIpVersion

string

協議版本。取值:

  • Ipv4:Ipv4 類型

Ipv4

CreateTime

string

資源建立時間,使用格林威治時間,格式為yyyy-MM-ddTHH:mm:ssZ

2024-07-08T10:12:58Z

LoadBalancerBusinessStatus

string

網關型負載平衡的業務狀態。取值:

  • Normal:正常狀態。

  • FinancialLocked:欠費鎖定狀態。

Normal

LoadBalancerId

string

網關型Server Load Balancer執行個體的 ID。

gwlb-9njtjmqt7zfcqm****

LoadBalancerName

string

網關型Server Load Balancer執行個體名稱。

長度為 2~128 個英文或中文字元,必須以字母或中文開頭,可包含數字、半形句號(.)、底線(_)和短劃線(-)。

gwlb

LoadBalancerStatus

string

網關型負載平衡的執行個體狀態。取值:

  • Active:運行中。

  • Inactive:已停止,表示執行個體監聽不會再轉寄流量。

  • Provisioning:建立中。

  • Configuring:變更配置中。

Active

RequestId

string

請求 ID。

B6DC5DDC-9560-59BF-80FA-ED1E5CB417DF

ResourceGroupId

string

資源群組 ID。

rg-acfmx7pmxcy****

Tags

array<object>

標籤列表。

object

標籤對象。

Key

string

標籤鍵。一旦傳入該值,則不允許為空白字串。

一個標籤健最多支援 128 個字元,不能以aliyunacs:開頭,不能包含http://或者https://

testTagKey

Value

string

標籤值。最多支援 256 個字元,不能包含http://https://

testTagValue

VpcId

string

專用網路 ID。

vpc-k1aajsbwbaq4todet****

ZoneMappings

array<object>

可用性區域及交換器映射列表。至少需要添加一個可用性區域,最多支援添加 20 個可用性區域。若當前地區支援 2 個及以上的可用性區域,建議添加 2 個及以上可用性區域。

array<object>

可用性區域及交換器映射對象。

LoadBalancerAddresses

array<object>

網關型Server Load Balancer執行個體地址清單。

object

網關型Server Load Balancer執行個體地址對象。

EniId

string

彈性網卡 ENI ID。

eni-bp1iahwz3rzgvltz****

PrivateIpv4Address

string

IPv4 私網地址。

192.168.XX.XX

VSwitchId

string

可用性區域對應的交換器,每個可用性區域只能使用一台交換器和一個子網。

vsw-uf6v8l7d2f1k53xrl****

ZoneId

string

可用性區域 ID。

cn-hangzhou-j

TrafficMode

string

流量模式。取值:

  • LoadBalance:負載平衡。

  • ByPass:繞行模式。

LoadBalance

樣本

正常返回樣本

JSON格式

{
  "AddressIpVersion": "Ipv4",
  "CreateTime": "2024-07-08T10:12:58Z",
  "LoadBalancerBusinessStatus": "Normal",
  "LoadBalancerId": "gwlb-9njtjmqt7zfcqm****",
  "LoadBalancerName": "gwlb",
  "LoadBalancerStatus": "Active",
  "RequestId": "B6DC5DDC-9560-59BF-80FA-ED1E5CB417DF",
  "ResourceGroupId": "rg-acfmx7pmxcy****",
  "Tags": [
    {
      "Key": "testTagKey",
      "Value": "testTagValue"
    }
  ],
  "VpcId": "vpc-k1aajsbwbaq4todet****",
  "ZoneMappings": [
    {
      "LoadBalancerAddresses": [
        {
          "EniId": "eni-bp1iahwz3rzgvltz****",
          "PrivateIpv4Address": "192.168.XX.XX"
        }
      ],
      "VSwitchId": "vsw-uf6v8l7d2f1k53xrl****",
      "ZoneId": "cn-hangzhou-j"
    }
  ],
  "TrafficMode": "LoadBalance"
}

錯誤碼

HTTP status code

錯誤碼

錯誤資訊

描述

400 ResourceNotFound.LoadBalancer The specified resource of %s is not found.
400 MissingParam.LoadBalancerId The param of LoadBalancerId is missing. 負載平衡ID參數缺失

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

變更歷史

更多資訊,參考變更詳情