Tüm Ürünler
Search
Belge Merkezi

:GetLoadBalancerAttribute

Son Güncelleme:Oct 02, 2026

Bir örnek kimliğine dayanarak Ağ Yük Dengeleyici (NLB) örneğinin ayrıntılı yapılandırmasını sorgular.

Hata Ayıklama

OpenAPI Explorer imza değerini otomatik olarak hesaplar. Kolaylık sağlaması açısından bu işlemi OpenAPI Explorer üzerinden çağırmanızı öneririz. OpenAPI Explorer, farklı SDK'lar için işlemin örnek kodunu dinamik olarak oluşturur.

İstek parametreleri

Parametre Tür Gerekli Örnek Açıklama
Action String Evet GetLoadBalancerAttribute

Gerçekleştirmek istediğiniz işlem. Değeri GetLoadBalancerAttribute olarak ayarlayın.

LoadBalancerId String Evet nlb-83ckzc8d4xlp8o****

NLB örneğinin kimliği.

DryRun Boolean Hayır false

Deneme çalıştırması yapılıp yapılmayacağını belirtir. Geçerli değerler:

  • true: Deneme çalıştırması gerçekleştirilir. Sistem gerekli parametreleri, istek sözdizimini ve sınırları kontrol eder. İstek deneme çalıştırmasında başarısız olursa hata nedenine göre bir hata kodu döndürülür. İstek deneme çalıştırmasını geçerse DryRunOperation hata kodu döndürülür.
  • false: Deneme çalıştırması gerçekleştirilir ve istek gönderilir. İstek deneme çalıştırmasını geçerse 2xx HTTP durum kodu döndürülür ve işlem gerçekleştirilir. Bu varsayılan değerdir.
ClientToken String Hayır 123e4567-e89b-12d3-a456-426655440000

İsteğin yinelenmezliğini (idempotence) sağlamak için kullanmak istediğiniz istemci belirteci.

Değeri istemci tarafında oluşturabilirsiniz ancak değerin tüm istekler arasında benzersiz olduğundan emin olmalısınız. ClientToken değeri yalnızca ASCII karakterleri içerir.

Not Bu parametreyi ayarlamazsanız sistem otomatik olarak RequestId değerini ClientToken değeri olarak kullanır. Her API isteği için RequestId değeri farklıdır.
RegionId String Hayır cn-hangzhou

NLB örneğinin dağıtıldığı bölgenin kimliği.

En güncel bölge listesini sorgulamak için DescribeRegions işlemini çağırabilirsiniz.

Yanıt parametreleri

Parametre Tür Örnek Açıklama
RequestId String CEF72CEB-54B6-4AE8-B225-F876FF7BA984

İsteğin kimliği.

RegionId String cn-hangzhou

NLB örneğinin dağıtıldığı bölgenin kimliği.

LoadBalancerId String nlb-83ckzc8d4xlp8o****

NLB örneğinin kimliği.

LoadBalancerName String NLB1

NLB örneğinin adı.

Ad 2 ila 128 karakter uzunluğunda olmalı; harfler, rakamlar, nokta (.), alt çizgi (_) ve kısa çizgi (-) içerebilir. Ad bir harfle başlamalıdır.

LoadBalancerType String network

Örneğin türü. Yalnızca NLB örneğini gösteren network döndürülür.

AddressType String Internet

NLB örneği tarafından kullanılan IPv4 adresi türü. Geçerli değerler:

  • Internet: NLB örneği bir genel IP adresi kullanır. NLB örneğinin alan adı genel IP adresine çözümlenir. Bu nedenle NLB örneğine İnternet üzerinden erişilebilir.
  • Intranet: NLB örneği bir özel IP adresi kullanır. NLB örneğinin alan adı özel IP adresine çözümlenir. Bu nedenle NLB örneğine, NLB örneğinin dağıtıldığı sanal özel bulut (VPC) üzerinden erişilebilir.
AddressIpVersion String ipv4

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

  • ipv4: IPv4
  • DualStack: çift yığın (dual stack)
Ipv6AddressType String Internet

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

  • Internet: NLB örneği bir genel IP adresi kullanır. NLB örneğinin alan adı genel IP adresine çözümlenir. Bu nedenle NLB örneğine İnternet üzerinden erişilebilir.
  • Intranet: NLB örneği bir özel IP adresi kullanır. NLB örneğinin alan adı özel IP adresine çözümlenir. Bu nedenle NLB örneğine, NLB örneğinin dağıtıldığı VPC üzerinden erişilebilir.
LoadBalancerStatus String Active

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

  • Inactive: NLB örneği devre dışı bırakılmıştır. Inactive durumundaki NLB örneklerinin dinleyicileri trafiği iletmez.
  • Active: NLB örneği çalışıyor.
  • Provisioning: NLB örneği oluşturuluyor.
  • Configuring: NLB örneği değiştiriliyor.
  • CreateFailed: Sistem NLB örneğini oluşturamadı. Bu durumda NLB örneği için ücretlendirilmezsiniz. NLB örneğini yalnızca silebilirsiniz.
LoadBalancerBusinessStatus String Normal

NLB örneğinin iş durumu. Geçerli değerler:

  • Abnormal: NLB örneği beklendiği gibi çalışmıyor.
  • Normal: NLB örneği beklendiği gibi çalışıyor.
OperationLocks OperationLock Dizisi

Kilitli olan NLB örneklerinin listesi. Bu parametre, LoadBalancerBussinessStatus değeri Abnormal olarak ayarlandığında döndürülür.

LockType String SecurityLocked

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

  • SecurityLocked: NLB örneği güvenlik nedenleriyle kilitlenmiştir.
  • RelatedResourceLocked: NLB örneği ilişkilendirme sorunları nedeniyle kilitlenmiştir.
  • FinancialLocked: NLB örneği geciken ödemeler nedeniyle kilitlenmiştir.
  • ResidualLocked: NLB örneği, ilişkili kaynakların ödemeleri geciktiği ve kaynaklar serbest bırakıldığı için kilitlenmiştir.
LockReason String Service exceptions.

NLB örneğinin kilitlenme nedeni.

VpcId String vpc-bp1b49rqrybk45nio****

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

CreateTime String 2022-07-02T02:49:05Z

Kaynağın oluşturulma zamanı. Zaman, yyyy-MM-ddTHH:mm:ssZ biçiminde UTC olarak görüntülenir.

ResourceGroupId String rg-atstuj3rtop****

Kaynak grubunun kimliği.

DNSName String nlb-wb7r6dlwetvt5j****.cn-hangzhou.nlb.aliyuncs.com

NLB örneğinin alan adı.

ZoneMappings ZoneMapping Dizisi

Alanlar ve bu alanlardaki vSwitch'lerin listesi. 2 ila 10 alan belirtmeniz gerekir.

VSwitchId String vsw-bp1rmcrwg3erh1fh8****

Alandaki vSwitch'in kimliği. Varsayılan olarak bir NLB örneğinin her alanı için yalnızca bir vSwitch (alt ağ) belirtebilirsiniz.

ZoneId String cn-hangzhou-a

Alanın kimliği. Alanları sorgulamak için DescribeZones işlemini çağırabilirsiniz.

LoadBalancerAddresses LoadBalancerAddress Dizisi

NLB örneği tarafından kullanılan IP adreslerine ilişkin bilgiler.

EniId String eni-bp12f1xhs5yal61a****

Elastic Network Interface (ENI) kimliği.

PrivateIPv4Address String 192.168.3.32

NLB örneğinin özel IPv4 adresi.

AllocationId String eip-bp1aedxso6u80u0qf****

Elastic IP Address (EIP) kimliği.

PublicIPv4Address String 120.XX.XX.69

NLB örneğinin genel IPv4 adresi.

Ipv6Address String 2001:db8:1:1:1:1:1:1

NLB örneğinin IPv6 adresi.

BandwidthPackageId String cbwp-bp1vevu8h3ieh****

İnternet'e yönelik NLB örneğiyle ilişkili EIP bant genişliği planının kimliği.

SecurityGroupIds String Dizisi sg-bp10uag3q0jkxu72****

NLB örneğiyle ilişkili güvenlik grubunun kimliği.

CrossZoneEnabled Boolean true

NLB örneği için alanlar arası yük dengelemenin etkin olup olmadığını gösterir. Geçerli değerler:

  • true: etkin
  • false: devre dışı
LoadBalancerBillingConfig Nesne

Faturalandırma yönteminin yapılandırması.

PayType String PostPay

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

Yalnızca kullandıkça öde faturalandırma yöntemini gösteren PostPay desteklenir.

Cps Integer 100

NLB örneğinde saniyede oluşturulabilecek maksimum bağlantı sayısı. Geçerli değerler: 0 ila 1000000.

0, bağlantı sayısının sınırsız olduğunu gösterir.

DeletionProtectionConfig Nesne

Silme koruması özelliğinin yapılandırması.

Enabled Boolean true

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

  • true: etkin
  • false: devre dışı
Reason String The instance is in the Running state.

Silme koruması özelliğinin etkin veya devre dışı bırakılma nedeni. Neden 2 ila 128 karakter uzunluğunda olmalı; harfler, rakamlar, nokta (.), alt çizgi (_) ve kısa çizgi (-) içerebilir. Neden bir harfle başlamalıdır.

EnabledTime String 2022-11-02T02:49:05Z

Silme korumasının etkinleştirildiği zaman. Zaman, yyyy-MM-ddTHH:mm:ssZ biçiminde UTC olarak görüntülenir.

ModificationProtectionConfig Nesne

Yapılandırma salt okunur modunun yapılandırması.

Status String ConsoleProtection

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

  • NonProtection: devre dışı. Reason parametresi ayarlanamaz. Reason ayarlanırsa değer temizlenir.
  • ConsoleProtection: etkin. Bu durumda Reason parametresi döndürülür.
Not Bu parametre ConsoleProtection olarak ayarlanırsa NLB konsolunda örnek yapılandırmalarını değiştiremezsiniz. Ancak API işlemlerini çağırarak örnek yapılandırmalarını değiştirebilirsiniz.
Reason String Service guarantee period

Yapılandırma salt okunur modunun etkinleştirilme nedeni. Neden 2 ila 128 karakter uzunluğunda olmalı; harfler, rakamlar, nokta (.), alt çizgi (_) ve kısa çizgi (-) içerebilir. Neden bir harfle başlamalıdır.

Bu parametre yalnızca Status parametresi ConsoleProtection olarak ayarlandığında geçerlidir.

EnabledTime String 2022-12-02T02:49:05Z

Yapılandırma salt okunur modunun etkinleştirildiği zaman. Zaman, yyyy-MM-ddTHH:mm:ssZ biçiminde UTC olarak görüntülenir.

Örnekler

Örnek istekler

http(s)://[Endpoint]/?Action=GetLoadBalancerAttribute
&LoadBalancerId=nlb-83ckzc8d4xlp8o****
&DryRun=false
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&RegionId=cn-hangzhou
&Common request parameters

Başarılı yanıt örnekleri

XML biçimi

HTTP/1.1 200 OK
Content-Type:application/xml

<GetLoadBalancerAttributeResponse>
    <RequestId>CEF72CEB-54B6-4AE8-B225-F876FF7BA984</RequestId>
    <RegionId>cn-hangzhou</RegionId>
    <LoadBalancerId>nlb-83ckzc8d4xlp8o****</LoadBalancerId>
    <LoadBalancerName>NLB1</LoadBalancerName>
    <LoadBalancerType>network</LoadBalancerType>
    <AddressType>Internet</AddressType>
    <AddressIpVersion>ipv4</AddressIpVersion>
    <Ipv6AddressType>Internet</Ipv6AddressType>
    <LoadBalancerStatus>Active</LoadBalancerStatus>
    <LoadBalancerBusinessStatus>Normal</LoadBalancerBusinessStatus>
    <OperationLocks>
        <LockType>SecurityLocked</LockType>
        <LockReason>Service exception. </LockReason>
    </OperationLocks>
    <VpcId>vpc-bp1b49rqrybk45nio****</VpcId>
    <CreateTime>2022-07-02T02:49:05Z</CreateTime>
    <ResourceGroupId>rg-atstuj3rtop****</ResourceGroupId>
    <DNSName>nlb-wb7r6dlwetvt5j****.cn-hangzhou.nlb.aliyuncs.com</DNSName>
    <ZoneMappings>
        <VSwitchId>vsw-bp1rmcrwg3erh1fh8****</VSwitchId>
        <ZoneId>cn-hangzhou-a</ZoneId>
        <LoadBalancerAddresses>
            <EniId>eni-bp12f1xhs5yal61a****</EniId>
            <PrivateIPv4Address>192.168.3.32</PrivateIPv4Address>
            <AllocationId>eip-bp1aedxso6u80u0qf****</AllocationId>
            <PublicIPv4Address>120.XX.XX.69</PublicIPv4Address>
            <Ipv6Address>2001:db8:1:1:1:1:1:1</Ipv6Address>
        </LoadBalancerAddresses>
    </ZoneMappings>
    <BandwidthPackageId>cbwp-bp1vevu8h3ieh****</BandwidthPackageId>
    <SecurityGroupIds>sg-bp10uag3q0jkxu72****</SecurityGroupIds>
    <CrossZoneEnabled>true</CrossZoneEnabled>
    <LoadBalancerBillingConfig>
        <PayType>PostPay</PayType>
    </LoadBalancerBillingConfig>
    <Cps>100</Cps>
    <DeletionProtectionConfig>
        <Enabled>true</Enabled>
        <Reason>The instance is in the Running state.</Reason>
        <EnabledTime>2022-11-02T02:49:05Z</EnabledTime>
    </DeletionProtectionConfig>
    <ModificationProtectionConfig>
        <Status>ConsoleProtection</Status>
        <Reason>Service guarantee period</Reason>
        <EnabledTime>2022-12-02T02:49:05Z</EnabledTime>
    </ModificationProtectionConfig>
</GetLoadBalancerAttributeResponse>

JSON biçimi

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "CEF72CEB-54B6-4AE8-B225-F876FF7BA984",
  "RegionId" : "cn-hangzhou",
  "LoadBalancerId" : "nlb-83ckzc8d4xlp8o****",
  "LoadBalancerName" : "NLB1",
  "LoadBalancerType" : "network",
  "AddressType" : "Internet",
  "AddressIpVersion" : "ipv4",
  "Ipv6AddressType" : "Internet",
  "LoadBalancerStatus" : "Active",
  "LoadBalancerBusinessStatus" : "Normal",
  "OperationLocks" : [ {
    "LockType" : "SecurityLocked",
    "LockReason" : "Service exception."
  } ],
  "VpcId" : "vpc-bp1b49rqrybk45nio****",
  "CreateTime" : "2022-07-02T02:49:05Z",
  "ResourceGroupId" : "rg-atstuj3rtop****",
  "DNSName" : "nlb-wb7r6dlwetvt5j****.cn-hangzhou.nlb.aliyuncs.com",
  "ZoneMappings" : [ {
    "VSwitchId" : "vsw-bp1rmcrwg3erh1fh8****",
    "ZoneId" : "cn-hangzhou-a",
    "LoadBalancerAddresses" : [ {
      "EniId" : "eni-bp12f1xhs5yal61a****",
      "PrivateIPv4Address" : "192.168.3.32",
      "AllocationId" : "eip-bp1aedxso6u80u0qf****",
      "PublicIPv4Address" : "120.XX.XX.69",
      "Ipv6Address" : "2001:db8:1:1:1:1:1:1"
    } ]
  } ],
  "BandwidthPackageId" : "cbwp-bp1vevu8h3ieh****",
  "SecurityGroupIds" : [ "sg-bp10uag3q0jkxu72****" ],
  "CrossZoneEnabled" : true,
  "LoadBalancerBillingConfig" : {
    "PayType" : "PostPay"
  },
  "Cps" : 100,
  "DeletionProtectionConfig" : {
    "Enabled" : true,
    "Reason" : "The instance is in the Running state.",
    "EnabledTime" : "2022-11-02T02:49:05Z"
  },
  "ModificationProtectionConfig" : {
    "Status" : "ConsoleProtection",
    "Reason" : "Service guarantee period",
    "EnabledTime" : "2022-12-02T02:49:05Z"
  }
}

Hata kodları

Hata kodlarının listesi için bkz. Hizmet hata kodları.