全部產品
Search
文件中心

Server Load Balancer:DescribeLoadBalancerAttribute - 查詢指定Server Load Balancer執行個體的詳細資料

更新時間:Dec 14, 2025

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

介面說明

說明

如果後端伺服器設定在虛擬伺服器組下面,請調用 DescribeVServerGroupAttribute 查詢。

調試

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

調試

授權資訊

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

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

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

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

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

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

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

slb:DescribeLoadBalancerAttribute

get

*loadbalancer

acs:slb:{#regionId}:{#accountId}:loadbalancer/{#loadbalancerId}

  • slb:tag
  • slb:tag
  • slb:tag
  • slb:tag
  • slb:tag

請求參數

名稱

類型

必填

描述

樣本值

RegionId

string

傳統型Server Load Balancer執行個體的地區 ID。

您可以通過調用 DescribeRegions 介面查詢地區 ID。

cn-hangzhou

LoadBalancerId

string

傳統型Server Load Balancer執行個體 ID。

lb-bp1b6c719dfa08ex****

返回參數

名稱

類型

描述

樣本值

object

VpcId

string

傳統型負載平衡私網執行個體的專用網路 ID。

vpc-25dvzy9f8****

Tags

object

Tag

array<object>

標籤列表。

object

標籤列表。

TagKey

string

執行個體的標籤鍵。N 的取值範圍:1~20。一旦輸入該值,則不允許為空白字串。

最多支援 64 個字元,不能以aliyunacs:開頭,不能包含http://或者https://

test

TagValue

string

執行個體的標籤值。N 的取值範圍:1~20。一旦輸入該值,可以為空白字串。

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

value

CreateTimeStamp

integer

傳統型Server Load Balancer執行個體建立時間戳記。

1504147745000

CreateTime

string

傳統型Server Load Balancer執行個體的建立時間。格式為:YYYY-MM-DDThh:mm:ssZ

2017-08-31T02:49:05Z

LoadBalancerId

string

傳統型Server Load Balancer執行個體的 ID。

lb-bp1b6c719dfa08ex****

PayType

string

傳統型Server Load Balancer執行個體付費類型。取值:

  • PayOnDemand(預設值):隨用隨付。

PayOnDemand

AddressType

string

傳統型Server Load Balancer執行個體的地址類型。

internet

NetworkType

string

傳統型Server Load Balancer執行個體的網路類型。

vpc

AddressIPVersion

string

IP 版本。取值:ipv4ipv6

ipv4

RenewalCycUnit

string

自動續約周期,取值:YearMonth(預設值)。

說明

該參數僅適用於中國站訂用帳戶執行個體,即 PayType 的參數值為 PrePayRenewalStatusAutoRenewal 時有效。

Month

RequestId

string

請求 ID。

365F4154-92F6-4AE4-92F8-7FF34B540710

Bandwidth

integer

按頻寬計費的公網型執行個體的頻寬峰值。

5

LoadBalancerName

string

傳統型Server Load Balancer執行個體的名稱。

lb-instance-test

Address

string

傳統型Server Load Balancer執行個體的服務地址。

42.XX.XX.6

SlaveZoneId

string

傳統型Server Load Balancer執行個體的備可用性區域 ID。

cn-hangzhou-d

EndTimeStamp

integer

傳統型Server Load Balancer執行個體結束時間戳記。

3249380160000

MasterZoneId

string

傳統型Server Load Balancer執行個體的主可用性區域 ID。

cn-hangzhou-b

LoadBalancerSpec

string

傳統型Server Load Balancer執行個體的效能規格。

說明

按使用量計費的執行個體無效能規格屬性,預設返回 slb.lcu.elastic

slb.s1.small

AutoReleaseTime

integer

釋放時間的時間戳記。

1513947075000

ModificationProtectionReason

string

設定修改保護狀態的原因,長度為 1~80 個字元,必須以字母或中文開頭,支援數字、半形句號(.)、底線(_)和短劃線(-)。

說明

僅在 ModificationProtectionStatusConsoleProtection 時有效。

執行個體業務保障期

RegionId

string

傳統型Server Load Balancer執行個體所在地區 ID。

cn-hangzhou

ModificationProtectionStatus

string

傳統型負載平衡修改保護狀態:

  • NonProtection:不限制修改保護,設定後會清空之前設定的 ModificationProtectionReason

  • ConsoleProtection:執行個體控制台修改保護狀態。

說明

當取值為 ConsoleProtection,即開啟修改保護後,使用者不能通過負載平衡控制台修改執行個體配置,但可以通過調用 API 修改執行個體配置。

ConsoleProtection

EndTime

string

傳統型Server Load Balancer執行個體結束時間。

2022-09-08T16:00:00Z

VSwitchId

string

私網執行個體的交換器 ID。

vsw-255ecrwq5****

LoadBalancerStatus

string

傳統型Server Load Balancer執行個體狀態:

  • inactive:執行個體已停止,此狀態的執行個體監聽不會再轉寄流量。

  • active:執行個體運行中,執行個體建立後,預設狀態為 active

  • locked:執行個體鎖定,執行個體已經欠費或被阿里雲鎖定。

active

ResourceGroupId

string

企業資源組 ID。

rg-atstuj3rtop****

InternetChargeType

string

公網類型執行個體付費方式。取值:

  • paybytraffic:按使用流量計費。

  • paybybandwidth:按固定頻寬計費。

paybytraffic

DeleteProtection

string

是否開啟執行個體刪除保護。

取值:onoff

off

RegionIdAlias

string

傳統型Server Load Balancer執行個體所屬的地區別名。

cn-hangzhou

RenewalStatus

string

續約狀態,取值:

  • AutoRenewal:自動續約。

  • Normal:非自動續約,您需要自行續約Server Load Balancer執行個體。

  • NotRenewal:不再續約。返回該值後,系統不再發送到期提醒,只在到期前第三天發送不續約提醒。

說明

該參數僅適用於中國站訂用帳戶執行個體,即 PayType 的參數值為 PrePay 時有效。

AutoRenewal

RenewalDuration

integer

自動續約時間長度,僅在 RenewalStatusAutoRenewal 時有效。

  • RenewalCycUnitYear 時,取值:1~5

  • RenewalCycUnitMonth 時,取值:1~9

說明

該參數僅適用於中國站訂用帳戶執行個體,即 PayType 的參數值為 PrePay 時有效。

1

ListenerPorts

object

ListenerPort

array

傳統型Server Load Balancer執行個體前端使用的連接埠。

integer

傳統型Server Load Balancer執行個體前端使用的連接埠。

80

ListenerPortsAndProtocal

object

ListenerPortAndProtocal

array<object>

監聽連接埠或協議。

object

傳統型Server Load Balancer執行個體前端使用的協議。

ListenerProtocal

string

傳統型Server Load Balancer執行個體前端使用的協議。

http

ListenerPort

integer

執行個體前端使用的連接埠。

443

ListenerPortsAndProtocol

object

ListenerPortAndProtocol

array<object>

執行個體前端使用的連接埠和協議。

object

執行個體前端使用的連接埠和協議。

ListenerPort

integer

執行個體前端使用的連接埠。

80

ListenerProtocol

string

執行個體前端使用的協議。

https

ListenerForward

string

是否啟用監聽轉寄。

on

Description

string

監聽連接埠和協議描述。

監聽描述

ForwardPort

integer

轉寄到的目的監聽連接埠,必須是已經存在的 HTTPS 監聽連接埠。

443

BackendServers

object

BackendServer

array<object>

執行個體的後端伺服器列表。

object

執行個體的後端伺服器列表。

Type

string

後端伺服器類型。 ecs:ECS 執行個體(預設)。 eni:彈性網卡執行個體。 eci:Elastic Container Instance。

ecs

Weight

integer

後端伺服器的權重。

90

Description

string

後端伺服器描述。

說明

若使用者未設定 Description,則該參數不返回。

用來接收轉寄請求的後端伺服器

ServerIp

string

ENI 或 ECI 的執行個體 ID。

192.XX.XX.11

ServerId

string

後端伺服器執行個體 ID。

i-2zej4lxhjoq1icu*****

InstanceChargeType

string

執行個體計費方式。取值:

  • PayBySpec:按規格計費。

  • PayByCLCU:按使用量計費。

PayBySpec

樣本

正常返回樣本

JSON格式

{
  "VpcId": "vpc-25dvzy9f8****",
  "Tags": {
    "Tag": [
      {
        "TagKey": "test",
        "TagValue": "value"
      }
    ]
  },
  "CreateTimeStamp": 1504147745000,
  "CreateTime": "2017-08-31T02:49:05Z",
  "LoadBalancerId": "lb-bp1b6c719dfa08ex****",
  "PayType": "PayOnDemand",
  "AddressType": "internet",
  "NetworkType": "vpc",
  "AddressIPVersion": "ipv4",
  "RenewalCycUnit": "Month",
  "RequestId": "365F4154-92F6-4AE4-92F8-7FF34B540710",
  "Bandwidth": 5,
  "LoadBalancerName": "lb-instance-test",
  "Address": "42.XX.XX.6",
  "SlaveZoneId": "cn-hangzhou-d",
  "EndTimeStamp": 3249380160000,
  "MasterZoneId": "cn-hangzhou-b",
  "LoadBalancerSpec": "slb.s1.small",
  "AutoReleaseTime": 1513947075000,
  "ModificationProtectionReason": "執行個體業務保障期",
  "RegionId": "cn-hangzhou",
  "ModificationProtectionStatus": "ConsoleProtection",
  "EndTime": "2022-09-08T16:00:00Z",
  "VSwitchId": "vsw-255ecrwq5****",
  "LoadBalancerStatus": "active",
  "ResourceGroupId": "rg-atstuj3rtop****",
  "InternetChargeType": "paybytraffic",
  "DeleteProtection": "off",
  "RegionIdAlias": "cn-hangzhou",
  "RenewalStatus": "AutoRenewal",
  "RenewalDuration": 1,
  "ListenerPorts": {
    "ListenerPort": [
      80
    ]
  },
  "ListenerPortsAndProtocal": {
    "ListenerPortAndProtocal": [
      {
        "ListenerProtocal": "http",
        "ListenerPort": 443
      }
    ]
  },
  "ListenerPortsAndProtocol": {
    "ListenerPortAndProtocol": [
      {
        "ListenerPort": 80,
        "ListenerProtocol": "https",
        "ListenerForward": "on",
        "Description": "監聽描述",
        "ForwardPort": 443
      }
    ]
  },
  "BackendServers": {
    "BackendServer": [
      {
        "Type": "ecs",
        "Weight": 90,
        "Description": "用來接收轉寄請求的後端伺服器",
        "ServerIp": "192.XX.XX.11",
        "ServerId": "i-2zej4lxhjoq1icu*****"
      }
    ]
  },
  "InstanceChargeType": "PayBySpec"
}

錯誤碼

HTTP status code

錯誤碼

錯誤資訊

描述

400 LocationServiceTimeout Location service connection timeout. Please try again later.
403 UnauthorizedRegion The specified region of is not authorized.

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

變更歷史

更多資訊,參考變更詳情