Tüm Ürünler
Search
Belge Merkezi

:GetLoadBalancerAttribute

Son Güncelleme:Sep 30, 2026

Bir Uygulama Yük Dengeleyici (ALB) örneğinin ayrıntılarını sorgular.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

  • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

  • API: The API that you can call to perform the action.

  • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

  • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

    • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

    • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

  • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

  • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

alb:GetLoadBalancerAttribute

get

*LoadBalancer

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

None None

Request parameters

Parameter

Type

Required

Description

Example

LoadBalancerId

string

Yes

ALB örneği kimliği.

alb-o9ulmq5hgn68jk****

Response elements

Element

Type

Description

Example

object

ALB örneği yapılandırmasının ayrıntıları.

AccessLogConfig

object

Erişim günlüğü özelliğinin yapılandırması.

LogProject

string

Log Service projesi.

sls-setter

LogStore

string

Logstore.

test

AddressAllocatedMode

string

IP adreslerinin tahsis edildiği mod. Geçerli değerler:

  • Fixed: ALB örneğine statik bir IP adresi tahsis eder.

  • Dynamic: ALB örneğinin her bölgesine dinamik olarak bir IP adresi tahsis eder.

Dynamic

AddressType

string

ALB örneğinin ağ türü. Geçerli değerler:

  • Internet: ALB örneği genel bir IP adresi kullanır. ALB örneğinin etki alanı adı genel IP adresine çözümlenir. Bu nedenle ALB örneğine İnternet üzerinden erişilebilir.

  • Intranet: ALB örneği özel bir IP adresi kullanır. ALB örneğinin etki alanı adı özel IP adresine çözümlenir. Bu durumda ALB örneğine, ALB örneğinin dağıtıldığı sanal özel bulut (VPC) üzerinden erişilebilir.

Intranet

BandwidthPackageId

string

İnternet'e açık ALB örneğiyle ilişkilendirilen esnek IP adresi (EIP) bant genişliği planının kimliği.

cbwp-bp1vevu8h3ieh****

CreateTime

string

Kaynağın oluşturulduğu zaman. Zaman, yyyy-MM-ddTHH:mm:ssZ formatında ISO 8601 standardını takip eder. Zaman UTC olarak görüntülenir.

2022-07-02T02:49:05Z

DNSName

string

ALB örneğinin etki alanı adı.

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

DeletionProtectionConfig

object

Silme koruması yapılandırması.

Enabled

boolean

Silme koruması özelliğinin etkin olup olmadığını gösterir. Geçerli değerler:

  • true

  • false

true

EnabledTime

string

Silme koruması özelliğinin etkinleştirildiği zaman. Zaman, yyyy-MM-ddTHH:mm:ssZ formatında ISO 8601 standardını takip eder. Zaman UTC olarak görüntülenir.

2022-08-02T02:49:05Z

LoadBalancerBillingConfig

object

ALB örneğinin faturalandırma yöntemi.

PayType

string

Faturalandırma yöntemi.

Yalnızca kullandıkça öde faturalandırma yöntemini belirten PostPay değeri döndürülür.

PostPay

LoadBalancerBussinessStatus

string

ALB örneğinin hizmet durumu. Geçerli değerler:

  • Abnormal

  • Normal

Normal

LoadBalancerEdition

string

ALB örneğinin sürümü. Özellikler ve faturalandırma kuralları ALB örneğinin sürümüne göre değişiklik gösterir. Geçerli değerler:

  • Basic

  • Standard

  • StandardWithWaf

Standard

LoadBalancerId

string

ALB örneği kimliği.

alb-o9ulmq5hgn68jk****

LoadBalancerName

string

ALB örneğinin adı.

Ad 2 ila 128 karakter uzunluğunda olmalı ve harf, rakam, nokta (.), alt çizgi (_) ve tire (-) içerebilir. Ad bir harfle başlamalıdır.

alb1

LoadBalancerOperationLocks

array<object>

Kilidin türü. Geçerli değerler:

  • SecurityLocked: ALB örneği güvenlik nedenleriyle kilitlenmiştir.

  • RelatedResourceLocked: ALB örneği ilişkilendirme sorunları nedeniyle kilitlenmiştir.

  • FinancialLocked: ALB örneği ödenmemiş borçlar nedeniyle kilitlenmiştir.

  • ResidualLocked: ALB örneği, ilişkilendirilen kaynakların ödenmemiş borçları olması ve kaynakların serbest bırakılması nedeniyle kilitlenmiştir.

object

LockReason

string

ALB örneğinin kilitlenme nedeni. Bu parametre yalnızca LoadBalancerBussinessStatus değeri Abnormal olarak ayarlandığında geçerlidir.

nolock

LockType

string

Kilit türü. Geçerli değerler:

  • SecurityLocked: ALB örneği güvenlik nedenleriyle kilitlenmiştir.

  • RelatedResourceLocked: ALB örneği, ALB örneğiyle ilişkilendirilen diğer kaynaklar nedeniyle kilitlenmiştir.

  • FinancialLocked: ALB örneği ödenmemiş borçlar nedeniyle kilitlenmiştir.

  • ResidualLocked: ALB örneği, ilişkilendirilen kaynakların ödenmemiş borçları olması ve kaynakların serbest bırakılması nedeniyle kilitlenmiştir.

FinancialLocked

LoadBalancerStatus

string

ALB örneğinin durumu. Geçerli değerler:

  • Inactive: ALB örneği devre dışıdır. Inactive durumundaki ALB örnekleri trafiği iletmez.

  • Active: ALB örneği çalışıyor.

  • Provisioning: ALB örneği oluşturuluyor.

  • Configuring: ALB örneği değiştiriliyor.

  • CreateFailed: Sistem ALB örneğini oluşturamadı. Bu durumda ALB örneği için ücretlendirilmezsiniz. Yalnızca ALB örneğini silebilirsiniz.

Active

ModificationProtectionConfig

object

Yapılandırma salt okunur modu ayarları.

Reason

string

Yapılandırma salt okunur modunun etkinleştirilme nedeni.

Ad 2 ila 128 karakter uzunluğunda olmalı ve harf, rakam, nokta (.), alt çizgi (_) ve tire (-) içerebilir. Bir harfle başlamalıdır.

Bu parametre yalnızca Status değeri ConsoleProtection olarak ayarlandığında etkili olur.

test

Status

string

Yapılandırma salt okunur modunun etkin olup olmadığını belirtir. Geçerli değerler:

  • NonProtection: Yapılandırma salt okunur modu devre dışıdır. Bu durumda, belirttiğiniz Reason parametresinin değeri etkili olmaz. Reason değerini ayarlarsanız değer temizlenir.

  • ConsoleProtection: Yapılandırma salt okunur modu etkindir. Bu durumda, Reason parametresinin değeri etkili olur.****

Not

Parametre ConsoleProtection olarak ayarlanırsa yapılandırma salt okunur modu etkinleştirilir. ALB konsolunda ALB örneğinin yapılandırmalarını değiştiremezsiniz. Ancak ALB örneğinin yapılandırmalarını değiştirmek için API işlemlerini çağırabilirsiniz.

ConsoleProtection

RegionId

string

ALB örneğinin bölge kimliği.

cn-hangzhou

RequestId

string

İstek kimliği.

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

ResourceGroupId

string

Kaynak grubu kimliği.

rg-atstuj3rtop****

Tags

array<object>

Etiket değeri.

Etiket değeri en fazla 128 karakter uzunluğunda olabilir ve acs: veya aliyun ile başlayamaz. Etiket değeri http:// veya https:// içeremez.

object

Key

string

Etiket anahtarı.

Etiket anahtarı en fazla 128 karakter uzunluğunda olabilir ve http:// veya https:// içeremez. acs: veya aliyun ile başlayamaz.

FinanceDept

Value

string

Etiket değeri.

Etiket değeri en fazla 128 karakter uzunluğunda olabilir ve http:// veya https:// içeremez. aliyun veya acs: ile başlayamaz.

FinanceJoshua

VpcId

string

ALB örneğinin dağıtıldığı VPC'nin kimliği.

vpc-bp1b49rqrybk45nio****

ZoneMappings

array<object>

Bölgeler ve vSwitch'ler arasındaki eşlemeler. En fazla 10 bölge döndürülür. Mevcut bölge iki veya daha fazla bölgeyi destekliyorsa en az iki bölge döndürülür.

array<object>

Bölgeler ve vSwitch'ler arasındaki eşlemeler. En fazla 10 bölge döndürülür. Mevcut bölge iki veya daha fazla bölgeyi destekliyorsa en az iki bölge döndürülür.

LoadBalancerAddresses

array<object>

ALB örneğinin adresi.

object

ALB örneğinin adresi.

Address

string

Bir IPv4 adresi.

Bu parametre AddressIPVersion değeri IPv4 veya DualStack olarak ayarlandığında etkili olur. Ağ türü AddressType değeri tarafından belirlenir.

192.168.10.1

Ipv6Address

string

Bir IPv6 adresi.

Bu parametre yalnızca AddressIPVersion değeri DualStack olarak ayarlandığında etkili olur. Ağ türü Ipv6AddressType değeri tarafından belirlenir.

2408:XXXX:39d:eb00::/56

IntranetAddress

string

Özel IPv4 adresi.

10.0.1.181

AllocationId

string

Esnek IP adresi (EIP).

eip-uf6wm****1zj9

EipType

string

EIP türü. Geçerli değerler:

  • Common: Bir EIP.

  • Anycast: Bir Anycast EIP.

Not

ALB'nin Anycast EIP'leri desteklediği bölgeler hakkında daha fazla bilgi için Sınırlar bölümüne bakın.

Common

IntranetAddressHcStatus

string

ALB örneğinin özel IPv4 adresinin sağlık durumu. Bu parametre yalnızca bölgenin Durumu Active olduğunda döndürülür. Geçerli değerler:

  • Healthy

  • Unhealthy

Healthy

Ipv6AddressHcStatus

string

ALB örneğinin özel IPv6 adresinin sağlık durumu. Bu parametre yalnızca bölgenin Durumu Active olduğunda döndürülür. Geçerli değerler:

  • Healthy

  • Unhealthy

Healthy

Ipv4LocalAddresses

array

IPv4 bağlantı yerel adresleri. ALB örneğinin arka uç sunucularla iletişim kurmak için kullandığı IP adresları.

string

IPv4 bağlantı yerel adresi.

10.1.0.62

Ipv6LocalAddresses

array

IPv6 bağlantı yerel adresleri. ALB örneğinin arka uç sunucularla iletişim kurmak için kullandığı IP adresları.

string

IPv6 bağlantı yerel adresi.

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

VSwitchId

string

Bölgedeki vSwitch. Bir ALB örneğinin her bölgesinde yalnızca bir vSwitch (alt ağ) belirtebilirsiniz.

vsw-bp12mw1f8k3jgy****

ZoneId

string

ALB örneğinin bölge kimliği.

En son bölge listesini sorgulamak için DescribeZones işlemini çağırabilirsiniz.

cn-hangzhou-a

Status

string

Bölge durumu. Geçerli değerler:

  • Active: ALB örneği çalışıyor.

  • Stopped: ALB örneği devre dışı.

  • Shifted: ALB örneği kaldırıldı.

  • Starting: ALB örneği başlatılıyor.

  • Stopping: ALB örneği durduruluyor.

Active

AddressIpVersion

string

IP sürümü. Geçerli değerler:

  • IPv4

  • DualStack

DualStack

Ipv6AddressType

string

ALB örneği tarafından kullanılan IPv6 adresinin türü. Geçerli değerler:

  • Internet: ALB örneği genel bir IP adresi kullanır. ALB örneğinin etki alanı adı genel IP adresine çözümlenir. Bu nedenle ALB örneğine İnternet üzerinden erişilebilir.

  • Intranet: ALB örneği özel bir IP adresi kullanır. ALB örneğinin etki alanı adı özel IP adresine çözümlenir. Bu nedenle ALB örneğine, ALB örneğinin dağıtıldığı VPC üzerinden erişilebilir.

Intranet

SecurityGroupIds

array

ALB örneğinin eklendiği güvenlik gruplarının kimlikleri.

string

ALB örneğinin eklendiği güvenlik grubunun kimliği.

sg-uf63j385dzwlm6cy****

Examples

Success response

JSON format

{
  "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": "Managed instance",
    "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****"
  ]
}

Error codes

HTTP status code

Error code

Error message

Description

400 Forbidden.LoadBalancer Authentication has failed for LoadBalancer.
404 ResourceNotFound.LoadBalancer The specified resource %s is not found. The specified resource %s is not found.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.