全部产品
Search
文档中心

Server Load Balancer:DescribeLoadBalancerAttribute

更新时间:Dec 14, 2025

Mengkueri detail instance Classic Load Balancer (CLB).

Deskripsi operasi

Catatan

Jika server backend ditempatkan dalam kelompok vServer, Anda dapat memanggil operasi DescribeVServerGroupAttribute untuk mengkueri server backend tersebut.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

  • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

  • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

  • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

  • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

    • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

    • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

  • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

  • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

slb:DescribeLoadBalancerAttribute

get

*loadbalancer

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

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

Parameter permintaan

Parameter

Type

Required

Description

Example

RegionId

string

No

ID wilayah instans CLB.

Anda dapat memanggil operasi DescribeRegions untuk mengkueri daftar wilayah terbaru.

cn-hangzhou

LoadBalancerId

string

Yes

ID instans CLB.

lb-bp1b6c719dfa08ex****

Elemen respons

Element

Type

Description

Example

object

VpcId

string

ID virtual private cloud (VPC) tempat instans CLB akses internal ditempatkan.

vpc-25dvzy9f8****

Tags

object

Tag

array<object>

Tag-tag.

object

TagKey

string

Kunci tag. Nilai N yang valid: 1 hingga 20. Kunci tag tidak boleh berupa string kosong.

Panjang kunci tag maksimal 64 karakter, dan tidak boleh mengandung http:// atau https://. Kunci tag tidak boleh diawali dengan aliyun atau acs:.

test

TagValue

string

Nilai tag. Nilai N yang valid: 1 hingga 20. Nilai tag boleh berupa string kosong.

Panjang nilai tag maksimal 128 karakter dan tidak boleh diawali dengan acs: atau aliyun. Nilai tag tidak boleh mengandung http:// atau https://.

value

CreateTimeStamp

integer

Timestamp yang dihasilkan saat sertifikat CA diunggah.

1504147745000

CreateTime

string

Waktu pembuatan instans CLB. Waktu menggunakan format YYYY-MM-DDThh:mm:ssZ.

2017-08-31T02:49:05Z

LoadBalancerId

string

ID instans CLB.

lb-bp1b6c719dfa08ex****

PayType

string

Metode penagihan instans CLB. Nilai yang valid:

  • Hanya PayOnDemand yang mungkin dikembalikan, yang menunjukkan metode penagihan bayar sesuai pemakaian.

PayOnDemand

AddressType

string

Jenis alamat instans CLB.

internet

NetworkType

string

Jenis jaringan instans CLB.

vpc

AddressIPVersion

string

Versi alamat IP. Nilai yang valid: ipv4 dan ipv6.

ipv4

RenewalCycUnit

string

Siklus perpanjangan otomatis. Nilai yang valid: Year dan Month. Nilai default: Month.

Catatan

Parameter ini hanya berlaku jika Anda membuat instans CLB langganan di situs Alibaba Cloud China. Dalam kasus ini, PayType harus diatur ke PrePay dan RenewalStatus harus diatur ke AutoRenewal.

Month

RequestId

string

ID permintaan.

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

Bandwidth

integer

Bandwidth maksimum instans CLB akses Internet yang ditagih berdasarkan metode bayar-per-bandwidth.

5

LoadBalancerName

string

Nama instans CLB.

lb-instance-test

Address

string

Alamat IP layanan instans CLB.

42.XX.XX.6

SlaveZoneId

string

ID zona sekunder tempat instans CLB berada.

cn-hangzhou-d

EndTimeStamp

integer

Timestamp yang menunjukkan waktu kedaluwarsa instans CLB.

32493801600000

MasterZoneId

string

ID zona primer tempat instans CLB berada.

cn-hangzhou-b

LoadBalancerSpec

string

Spesifikasi instans CLB.

Catatan

Instans CLB pay-as-you-go tidak tunduk pada spesifikasi. Secara default, slb.lcu.elastic dikembalikan.

slb.s1.small

AutoReleaseTime

integer

Timestamp yang dihasilkan saat instans CLB dirilis.

1513947075000

ModificationProtectionReason

string

Alasan diaktifkannya mode baca-saja konfigurasi. Nilai terdiri dari 1 hingga 80 karakter. Diawali dengan huruf dan dapat mengandung angka, titik (.), garis bawah (_), dan tanda hubung (-).

Catatan

Parameter ini hanya berlaku ketika ModificationProtectionStatus diatur ke ConsoleProtection.

Managed instance

RegionId

string

ID wilayah instans CLB.

cn-hangzhou

ModificationProtectionStatus

string

Menunjukkan apakah mode baca-saja konfigurasi diaktifkan. Nilai yang valid:

  • NonProtection: Mode baca-saja konfigurasi dinonaktifkan. Setelah Anda menonaktifkan mode baca-saja konfigurasi, nilai ModificationProtectionReason akan dihapus.

  • ConsoleProtection: Mode baca-saja konfigurasi diaktifkan.

Catatan

Jika parameter ini diatur ke ConsoleProtection, Anda tidak dapat mengubah konfigurasi instans di Konsol CLB. Namun, Anda tetap dapat mengubah konfigurasi instans dengan memanggil operasi API.

ConsoleProtection

EndTime

string

Waktu kedaluwarsa instans CLB.

2022-09-08T16:00:00Z

VSwitchId

string

ID vSwitch tempat instans CLB akses internal berada.

vsw-255ecrwq5****

LoadBalancerStatus

string

Status instans CLB. Nilai yang valid:

  • inactive: Instans CLB dinonaktifkan. Instans CLB dalam status inactive tidak meneruskan traffic.

  • active: Instans CLB berjalan sebagaimana mestinya. Instans CLB yang baru dibuat secara default berada dalam status active.

  • locked: Instans CLB terkunci. Instans CLB dapat terkunci karena pembayaran tertunda atau alasan lainnya.

active

ResourceGroupId

string

ID kelompok sumber daya.

rg-atstuj3rtop****

InternetChargeType

string

Metode pengukuran instans CLB akses Internet. Nilai yang valid:

  • paybytraffic

  • paybybandwidth

paybytraffic

DeleteProtection

string

Menunjukkan apakah perlindungan penghapusan diaktifkan untuk instans CLB.

Nilai yang valid: on dan off.

off

RegionIdAlias

string

Alias wilayah tempat instans CLB berada.

hangzhou

RenewalStatus

string

Menunjukkan apakah perpanjangan otomatis diaktifkan. Nilai yang valid:

  • AutoRenewal: Perpanjangan otomatis diaktifkan.

  • Normal: Perpanjangan otomatis dinonaktifkan. Anda harus memperpanjang instans CLB secara manual.

  • NotRenewal: Instans CLB tidak akan diperpanjang setelah kedaluwarsa. Jika nilai ini dikembalikan, sistem tidak mengirim notifikasi hingga tiga hari sebelum tanggal kedaluwarsa.

    **

    Note Parameter ini hanya berlaku jika Anda membuat instans CLB langganan di situs Alibaba Cloud China. Dalam kasus ini, parameter PayType harus diatur ke PrePay.

AutoRenewal

RenewalDuration

integer

Durasi perpanjangan otomatis. Parameter ini hanya berlaku jika RenewalStatus diatur ke AutoRenewal.

  • Nilai yang valid ketika PeriodUnit diatur ke Year: 1~5.

  • Nilai yang valid ketika PeriodUnit diatur ke Month: 1~ 9.

Catatan

Parameter ini hanya berlaku jika Anda membuat instans CLB langganan di situs Alibaba Cloud China. Dalam kasus ini, parameter PayType harus diatur ke PrePay.

1

ListenerPorts

object

ListenerPort

array

Port frontend yang digunakan oleh instans CLB.

integer

Port frontend yang digunakan oleh instans CLB.

80

ListenerPortsAndProtocal

object

ListenerPortAndProtocal

array<object>

Port atau protokol pendengar.

object

ListenerProtocal

string

Protokol frontend yang digunakan oleh instans CLB.

http

ListenerPort

integer

Port frontend yang digunakan oleh instans CLB.

443

ListenerPortsAndProtocol

object

ListenerPortAndProtocol

array<object>

Port atau protokol pendengar.

object

ListenerPort

integer

Port frontend yang digunakan oleh instans CLB.

80

ListenerProtocol

string

Protokol frontend yang digunakan oleh instans CLB.

https

ListenerForward

string

Menunjukkan apakah pendengar diaktifkan.

on

Description

string

Menunjukkan apakah pendengar diaktifkan.

Listener Description

ForwardPort

integer

Port tujuan tempat permintaan diteruskan. Port tersebut harus terbuka dan menggunakan HTTPS.

443

BackendServers

object

BackendServer

array<object>

Server backend instans CLB.

object

Type

string

Jenis server backend.

ecs

Weight

integer

Bobot server backend.

90

Description

string

Deskripsi server backend.

Catatan

Parameter ini tidak dikembalikan jika Description tidak diatur.

backend server description

ServerIp

string

ID antarmuka jaringan elastis (ENI) atau instans kontainer elastis.

192.XX.XX.11

ServerId

string

ID server backend.

i-2zej4lxhjoq1icu*****

Contoh

Respons sukses

JSONformat

{
  "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"
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

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

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.