Ambil instans CLB melalui API DescribeLoadBalancers - Classic Load Balancer - Alibaba Cloud - Server Load Balancer

Anda dapat mengkueri Instans SLB yang telah dibuat.

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:DescribeLoadBalancers

get

*LoadBalancer

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

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	ID Wilayah Instans Classic Load Balancer (CLB). Anda dapat memanggil operasi DescribeRegions untuk mengkueri ID Wilayah.	cn-hangzhou
ServerId	string	No	ID server backend yang ditambahkan ke Instans CLB.	i-2zebcbq******
AddressIPVersion	string	No	Versi IP. Tetapkan nilai ke ipv4 atau ipv6.	ipv4
LoadBalancerStatus	string	No	Status Instans. Nilai valid: inactive: Instans dihentikan. Pendengar Instans dalam status ini tidak meneruskan Trafik. active: Instans Berjalan. Ini adalah status default Instans setelah dibuat. locked: Instans terkunci. Instans memasuki status terkunci setelah kedaluwarsa. Status ini berlangsung selama tujuh hari. Anda tidak dapat melakukan operasi pada Instans. Instans tidak meneruskan Trafik, tetapi alamat IP dan konfigurasi lainnya tetap dipertahankan.	active
LoadBalancerId	string	No	ID Instans CLB. Anda dapat menentukan hingga 10 ID, dipisahkan dengan koma (,).	lb-bp1b6c719dfa****
LoadBalancerName	string	No	Nama Instans CLB. Nama harus terdiri dari 1 hingga 80 karakter. Harus dimulai dengan huruf atau karakter Cina. Dapat berisi huruf, angka, titik (.), garis bawah (_), dan tanda hubung (-). Anda dapat menentukan hingga 10 nama. Pisahkan beberapa nama dengan koma (,).	test
ServerIntranetAddress	string	No	Alamat IP internal server backend yang ditambahkan. Anda dapat menentukan beberapa alamat IP. Pisahkan dengan koma (,).	10.XX.XX.102
AddressType	string	No	Jenis jaringan Instans CLB. Nilai valid: internet: Instans CLB yang menghadap Internet. Sistem menetapkan alamat IP publik ke Instans. Instans dapat meneruskan permintaan dari Internet. intranet: Instans CLB yang menghadap internal. Sistem menetapkan alamat IP privat ke Instans. Instans hanya dapat meneruskan permintaan dalam jaringan internal.	intranet
InternetChargeType	string	No	Metode penagihan Instans CLB yang menghadap Internet. Nilai valid: paybybandwidth: bayar-per-bandwidth. paybytraffic: bayar-per-Trafik.	paybytraffic
VpcId	string	No	ID virtual private cloud (VPC) tempat Instans CLB berada.	vpc-bp1aevy8sof****
VSwitchId	string	No	ID vSwitch tempat Instans CLB berada.	vsw-bp12mw1f8k3****
NetworkType	string	No	Jenis jaringan Instans CLB yang menghadap internal. Nilai valid: vpc: VPC. classic: jaringan klasik.	vpc
Address	string	No	Alamat layanan Instans CLB.	192.168.XX.XX
MasterZoneId	string	No	ID zona utama Instans CLB.	cn-hangzhou-b
SlaveZoneId	string	No	ID zona sekunder Instans CLB. Fitur multi-zona tidak tersedia untuk pengguna Alibaba Cloud Keuangan.	cn-hangzhou-d
Tags	string	No	Tag yang ditambahkan ke Instans CLB. Nilainya adalah kamus JSON yang terdiri dari kunci tag dan nilai tag. Anda dapat menambahkan hingga 10 tag di setiap permintaan.	[{"tagKey":"Key1","tagValue":"Value1"}]
PayType	string	No	Metode penagihan Instans CLB. Nilai valid: PayOnDemand: bayar-sesuai-pemakaian. .	PayOnDemand
ResourceGroupId	string	No	ID kelompok sumber daya.	rg-acfmxazb4p****
PageNumber	integer	No	Nomor halaman yang akan dikembalikan.	1
PageSize	integer	No	Jumlah entri yang akan dikembalikan di setiap halaman. Nilai valid: 1 hingga 100. Catatan Jika Anda menetapkan PageSize, Anda juga harus menetapkan PageNumber.	50
Tag	array<object>	No	Daftar tag.
	object	No	The list of tags.
Key	string	No	The key of tag N. Valid values of N: 1 to 20. The tag key cannot be an empty string. The tag key can be up to 64 characters in length and cannot start with `aliyun` or `acs:`. It cannot contain `http://` or `https://`.	FinanceDept
Value	string	No	The value of tag N. Valid values of N: 1 to 20. The tag value can be an empty string. The tag value can be up to 128 characters in length. It cannot start with `aliyun` or `acs:`. It cannot contain `http://` or `https://`.	FinanceJoshua

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	The request ID.	8B9DB03B-ED39-5DB8-9C9F-1ED5F548D61E
PageNumber	integer	The page number of the returned page.	1
PageSize	integer	The number of entries returned on the current page.	50
TotalCount	integer	The total number of instances that meet the filter conditions.	1
LoadBalancers	object
LoadBalancer	array<object>	The list of CLB instances.
	array<object>	The list of CLB instances.
VpcId	string	The ID of the VPC in which the internal-facing CLB instance is deployed.	vpc-25dvzy9f8****
CreateTimeStamp	integer	The timestamp that indicates when the instance was created.	1504147745000
LoadBalancerId	string	The ID of the CLB instance.	lb-bp1b6c719dfa****
CreateTime	string	The time when the instance was created. The time is in the `YYYY-MM-DDThh:mm:ssZ` format.	2021-12-02T02:49:05Z
PayType	string	The billing method of the CLB instance. Valid values: PayOnDemand: pay-as-you-go.	PayOnDemand
AddressType	string	The network type of the instance. Valid values: internet: An Internet-facing CLB instance. The system assigns a public IP address to the instance. The instance can forward requests from the Internet. intranet: An internal-facing CLB instance. The system assigns a private IP address to the instance. The instance can forward requests only within internal networks.	intranet
NetworkType	string	The network type of the internal-facing CLB instance. Valid values: vpc: a VPC. classic: a classic network.	vpc
AddressIPVersion	string	The IP version. Valid values: ipv4 and ipv6.	ipv4
LoadBalancerName	string	The name of the CLB instance.	lb-bp1o94dp5i6ea****
Bandwidth	integer	The peak bandwidth of the listener. Unit: Mbit/s.	-1
Address	string	The service address of the CLB instance.	100.XX.XX.28
SlaveZoneId	string	The ID of the secondary zone of the instance.	cn-hangzhou-d
MasterZoneId	string	The ID of the primary zone of the instance.	cn-hangzhou-b
InternetChargeTypeAlias	string	The billing method of the Internet-facing CLB instance. Valid values: paybybandwidth: pay-by-bandwidth. paybytraffic: pay-by-data-transfer	paybybandwidth
LoadBalancerSpec	string	The specification of the CLB instance. Catatan Pay-by-data-transfer instances have no specification. The default value slb.lcu.elastic is returned.	slb.s1.small
RegionId	string	The region ID of the CLB instance.	cn-hangzhou
ModificationProtectionReason	string	The reason why the configuration read-only mode is enabled. The reason must be 1 to 80 characters in length. It must start with a letter or a Chinese character. It can contain letters, digits, periods (.), underscores (_), and hyphens (-). Catatan This parameter is valid only if `ModificationProtectionStatus` is set to ConsoleProtection.	ManagedInstance
ModificationProtectionStatus	string	The status of the configuration read-only mode: NonProtection: The configuration read-only mode is disabled. After you disable the mode, the value of `ModificationProtectionReason` is cleared. ConsoleProtection: The configuration read-only mode is enabled. Catatan If the value is ConsoleProtection, the configuration read-only mode is enabled. You cannot modify the instance configuration in the CLB console. However, you can call API operations to modify the instance configuration.	ConsoleProtection
VSwitchId	string	The ID of the vSwitch in the VPC where the internal-facing CLB instance is deployed.	vsw-255ecr****
LoadBalancerStatus	string	The state of the CLB instance. Valid values: inactive: The instance is stopped. Listeners of an instance in this state do not forward traffic. active: The instance is running. This is the default state of an instance after it is created. locked: The instance is locked.	active
ResourceGroupId	string	The ID of the resource group.	rg-atstuj3r****
InternetChargeType	string	The billing method of the Internet-facing instance. Valid values: 3: pay-by-bandwidth. 4: pay-by-data-transfer.	3
DeleteProtection	string	Indicates whether deletion protection is enabled for the CLB instance. Valid values: on: enabled. off: disabled.	off
RegionIdAlias	string	The name of the region where the CLB instance is deployed.	cn-hangzhou
Tags	object
Tag	array<object>	The list of tags
	object	The list of tags
TagValue	string	The tag value.	testvalue
TagKey	string	The tag key.	testkey
InstanceChargeType	string	实例计费方式，取值： PayBySpec：按规格计费。 PayByCLCU：按使用量计费。 Catatan 该参数仅适用于中国站且当 PayType（实例付费模式）取值为 PayOnDemand（按量付费）时，该参数生效。	PayBySpec

Contoh

Respons sukses

JSONformat

{
  "RequestId": "8B9DB03B-ED39-5DB8-9C9F-1ED5F548D61E",
  "PageNumber": 1,
  "PageSize": 50,
  "TotalCount": 1,
  "LoadBalancers": {
    "LoadBalancer": [
      {
        "VpcId": "vpc-25dvzy9f8****",
        "CreateTimeStamp": 1504147745000,
        "LoadBalancerId": "lb-bp1b6c719dfa****",
        "CreateTime": "2021-12-02T02:49:05Z",
        "PayType": "PayOnDemand",
        "AddressType": "intranet",
        "NetworkType": "vpc",
        "AddressIPVersion": "ipv4",
        "LoadBalancerName": "lb-bp1o94dp5i6ea****",
        "Bandwidth": -1,
        "Address": "100.XX.XX.28",
        "SlaveZoneId": "cn-hangzhou-d",
        "MasterZoneId": "cn-hangzhou-b",
        "InternetChargeTypeAlias": "paybybandwidth",
        "LoadBalancerSpec": "slb.s1.small",
        "RegionId": "cn-hangzhou",
        "ModificationProtectionReason": "ManagedInstance",
        "ModificationProtectionStatus": "ConsoleProtection",
        "VSwitchId": "vsw-255ecr****",
        "LoadBalancerStatus": "active",
        "ResourceGroupId": "rg-atstuj3r****",
        "InternetChargeType": "3",
        "DeleteProtection": "off",
        "RegionIdAlias": "cn-hangzhou",
        "Tags": {
          "Tag": [
            {
              "TagValue": "testvalue",
              "TagKey": "testkey"
            }
          ]
        }
      }
    ]
  }
}

Kode kesalahan

HTTP status code	Error code	Error message
400	InvalidTag	The specified tags is invalid.
400	TooManyResult	fuzzy query retrieve too many instances.
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.