全部產品
Search
文件中心

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

更新時間:Dec 19, 2025

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

調試

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

調試

授權資訊

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

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

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

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

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

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

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

alb:GetLoadBalancerAttribute

get

*LoadBalancer

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

請求參數

名稱

類型

必填

描述

樣本值

LoadBalancerId

string

應用型Server Load Balancer執行個體 ID。

alb-o9ulmq5hgn68jk****

返回參數

名稱

類型

描述

樣本值

object

應用型Server Load Balancer執行個體詳細配置資訊。

AccessLogConfig

object

訪問日誌配置。

LogProject

string

記錄項目。

sls-setter

LogStore

string

日誌儲存。

test

AddressAllocatedMode

string

地址模式。取值 :

  • Fixed:固定 IP 模式,表示使用固定的 IP 位址。

  • Dynamic:動態 IP 模式,表示在每個可用性區域動態分配 IP 位址。

Dynamic

AddressType

string

應用型Server Load Balancer執行個體的網路地址類型。取值:

  • Internet:負載平衡具有公網 IP 位址,DNS 網域名稱被解析到公網 IP,因此可以在公網環境訪問。

  • Intranet:負載平衡只有私網 IP 位址,DNS 網域名稱被解析到私網 IP,因此只能被負載平衡所在 VPC 的內網環境訪問。

Intranet

BandwidthPackageId

string

公網類型執行個體關聯的共用頻寬包 ID。

cbwp-bp1vevu8h3ieh****

CreateTime

string

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

2022-07-02T02:49:05Z

DNSName

string

DNS 網域名稱。

alb-95qnr2itwu9orb****.cn-hangzhou.alb.aliyuncs.com

DeletionProtectionConfig

object

刪除保護配置。

Enabled

boolean

刪除保護狀態,取值:

  • true:開啟狀態。

  • false:關閉狀態。

true

EnabledTime

string

刪除保護開啟時間,使用格林威治時間,格式為yyyy-MM-ddTHH:mm:ssZ

2022-08-02T02:49:05Z

LoadBalancerBillingConfig

object

應用型Server Load Balancer執行個體計費配置。

PayType

string

計費類型。

取值: PostPay 表示隨用隨付。

PostPay

LoadBalancerBussinessStatus

string

應用型負載平衡的業務狀態。取值:

  • Abnormal:異常狀態。

  • Normal:正常狀態。

Normal

LoadBalancerEdition

string

應用型負載平衡的版本,不同版本有不同功能限制和計費策略。取值:

  • Basic:基礎版。

  • Standard:標準版。

  • StandardWithWaf:WAF 增強版。

Standard

LoadBalancerId

string

應用型Server Load Balancer執行個體 ID。

alb-o9ulmq5hgn68jk****

LoadBalancerName

string

執行個體名稱。

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

alb1

LoadBalancerOperationLocks

array<object>

應用型負載平衡操作鎖配置。

object

應用型負載平衡操作鎖配置。

LockReason

string

鎖定的原因。在 LoadBalancerBussinessStatus異常時有效。

欠費

LockType

string

鎖定的類型。取值 :

  • SecurityLocked:安全鎖定。

  • RelatedResourceLocked:關聯鎖定。

  • FinancialLocked:欠費鎖定。

  • ResidualLocked:殘留鎖定。

FinancialLocked

LoadBalancerStatus

string

應用型Server Load Balancer執行個體狀態。取值:

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

  • Active: 運行中。

  • Provisioning:建立中。

  • Configuring:變更配置中。

  • CreateFailed:建立失敗,此時不會產生費用,執行個體只能被刪除。

Active

ModificationProtectionConfig

object

修改保護配置。

Reason

string

開啟修改保護的原因。

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

僅在 StatusConsoleProtection 時返回。

受管理的執行個體

Status

string

應用型Server Load Balancer執行個體的修改保護狀態。取值:

  • NonProtection:未開啟修改保護。如有配置 ReasonReason 會被強制置空。

  • ConsoleProtection:已開啟控制台修改保護。如有配置 ReasonReason 可生效。

說明

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

ConsoleProtection

RegionId

string

應用型Server Load Balancer執行個體的地區 ID。

cn-hangzhou

RequestId

string

請求 ID。

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

ResourceGroupId

string

企業資源組 ID。

rg-atstuj3rtop****

Tags

array<object>

標籤。

object

標籤。

Key

string

執行個體的標籤鍵。

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

FinanceDept

Value

string

執行個體的標籤值。

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

FinanceJoshua

VpcId

string

執行個體的專用網路 ID。

vpc-bp1b49rqrybk45nio****

ZoneMappings

array<object>

可用性區域及交換器映射列表,最多返回 10 個可用性區域。若當前地區支援 2 個及以上可用性區域,至少返回 2 個及以上可用性區域。

array<object>

可用性區域及交換器映射列表,最多返回 10 個可用性區域。若當前地區支援 2 個及以上可用性區域,至少返回 2 個及以上可用性區域。

LoadBalancerAddresses

array<object>

執行個體地址。

object

執行個體地址。

Address

string

標識 IPv4 類型的 IP 位址。

AddressIPVersionIPv4DualStack 均生效,公網或私網 IP 位址由 AddressType 決定。

10.1.0.61

Ipv6Address

string

標識 IPv6 類型的 IP 位址。

僅在 AddressIPVersionDualStack 時有效,公網或私網 IP 位址由 Ipv6AddressType 決定。

2408:xxxx:249:dd01:6f4:750f:xxxx:bcd9

IntranetAddress

string

IPv4 私網地址。

10.1.0.61

AllocationId

string

彈性公網 IP 標識。

eip-uf6wm****1zj9

EipType

string

公網 EIP 的類型。取值:

  • Common:彈性公網 IP,簡稱 EIP。

  • Anycast:任播彈性公網 IP,簡稱 Anycast EIP。

說明

ALB 支援綁定 Anycast EIP 的地區,請參見使用限制

Common

IntranetAddressHcStatus

string

應用型Server Load Balancer執行個體私網 IPv4 地址探測狀態。

只有可用性區域的狀態為 Active 時才返回。取值:

  • Healthy:健康。

  • Unhealthy:異常。

Healthy

Ipv6AddressHcStatus

string

應用型Server Load Balancer執行個體 IPv6 地址探測狀態。

只有可用性區域的狀態為 Active 時才返回。取值:

  • Healthy:健康。

  • Unhealthy:異常。

Healthy

Ipv4LocalAddresses

array

IPv4 Local 地址清單。ALB 與後端服務互動使用的地址清單。

string

IPv4 Local 地址。

10.1.0.62

Ipv6LocalAddresses

array

IPv6 Local 地址清單。ALB 與後端服務互動使用的地址清單。

string

IPv6 Local 地址。

2408:xxxx:249:dd01:6f4:750f:xxxx:bcda

VSwitchId

string

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

vsw-bp12mw1f8k3jgy****

ZoneId

string

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

您可以通過調用 DescribeZones 介面擷取可用性區域 ID 對應的可用性區域的資訊。

cn-hangzhou-a

Status

string

可用性區域狀態。取值:

  • Active:運行中。

  • Stopped:已停止。

  • Shifted:已移除。

  • Starting:啟動中。

  • Stopping:停止中。

Active

AddressIpVersion

string

協議版本。取值:

  • IPv4:IPv4 類型

  • DualStack:雙棧類型

DualStack

Ipv6AddressType

string

應用型負載平衡 IPv6 的網路地址類型。取值:

  • Internet:公網。負載平衡具有公網 IP 位址,DNS 網域名稱被解析到公網 IP,因此可以在公網環境訪問。

  • Intranet:私網。負載平衡只有私網 IP 位址,DNS 網域名稱被解析到私網 IP,因此只能被負載平衡所在 VPC 的內網環境訪問。

Intranet

SecurityGroupIds

array

應用型Server Load Balancer執行個體綁定的安全性群組 ID 集合。

string

應用型Server Load Balancer執行個體綁定的安全性群組 ID。

sg-uf63j385dzwlm6cy****

樣本

正常返回樣本

JSON格式

{
  "AccessLogConfig": {
    "LogProject": "sls-setter",
    "LogStore": "test"
  },
  "AddressAllocatedMode": "Dynamic",
  "AddressType": "Intranet",
  "BandwidthPackageId": "cbwp-bp1vevu8h3ieh****",
  "CreateTime": "2022-07-02T02:49:05Z",
  "DNSName": "alb-95qnr2itwu9orb****.cn-hangzhou.alb.aliyuncs.com",
  "DeletionProtectionConfig": {
    "Enabled": true,
    "EnabledTime": "2022-08-02T02:49:05Z"
  },
  "LoadBalancerBillingConfig": {
    "PayType": "PostPay"
  },
  "LoadBalancerBussinessStatus": "Normal",
  "LoadBalancerEdition": "Standard",
  "LoadBalancerId": "alb-o9ulmq5hgn68jk****",
  "LoadBalancerName": "alb1",
  "LoadBalancerOperationLocks": [
    {
      "LockReason": "欠費",
      "LockType": "FinancialLocked"
    }
  ],
  "LoadBalancerStatus": "Active",
  "ModificationProtectionConfig": {
    "Reason": "受管理的執行個體",
    "Status": "ConsoleProtection"
  },
  "RegionId": "cn-hangzhou",
  "RequestId": "365F4154-92F6-4AE4-92F8-7FF34B540710",
  "ResourceGroupId": "rg-atstuj3rtop****",
  "Tags": [
    {
      "Key": "FinanceDept",
      "Value": "FinanceJoshua"
    }
  ],
  "VpcId": "vpc-bp1b49rqrybk45nio****",
  "ZoneMappings": [
    {
      "LoadBalancerAddresses": [
        {
          "Address": "10.1.0.61",
          "Ipv6Address": "2408:xxxx:249:dd01:6f4:750f:xxxx:bcd9",
          "IntranetAddress": "10.1.0.61",
          "AllocationId": "eip-uf6wm****1zj9",
          "EipType": "Common",
          "IntranetAddressHcStatus": "Healthy",
          "Ipv6AddressHcStatus": "Healthy",
          "Ipv4LocalAddresses": [
            "10.1.0.62"
          ],
          "Ipv6LocalAddresses": [
            "2408:xxxx:249:dd01:6f4:750f:xxxx:bcda"
          ]
        }
      ],
      "VSwitchId": "vsw-bp12mw1f8k3jgy****",
      "ZoneId": "cn-hangzhou-a",
      "Status": "Active"
    }
  ],
  "AddressIpVersion": "DualStack",
  "Ipv6AddressType": "Intranet",
  "SecurityGroupIds": [
    "sg-uf63j385dzwlm6cy****"
  ]
}

錯誤碼

HTTP status code

錯誤碼

錯誤資訊

描述

400 Forbidden.LoadBalancer Authentication has failed for LoadBalancer.
404 ResourceNotFound.LoadBalancer The specified resource %s is not found. 資源%s不存在。

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

變更歷史

更多資訊,參考變更詳情