Gunakan ListEndpointGroups - Global Accelerator - Alibaba Cloud - Global Accelerator

Mengkueri daftar kelompok titik akhir.

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

ga:ListEndpointGroups

list

*EndpointGroup

acs:ga:{#regionId}:{#accountId}:endpointgroup/*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	ID wilayah instans Alibaba Cloud Akselerator Global (GA). Tetapkan nilai menjadi cn-hangzhou.	cn-hangzhou
PageNumber	integer	No	Nomor halaman daftar. Nilai default: 1.	1
PageSize	integer	No	Jumlah entri per halaman untuk kueri berhalaman. Nilai maksimum: 50. Nilai default: 10.	10
AcceleratorId	string	Yes	ID instans Alibaba Cloud Akselerator Global (GA).	ga-bp1odcab8tmno0hdq****
ListenerId	string	No	ID instans pendengar.	lsr-bp1bpn0kn908w4nbw****
EndpointGroupType	string	No	Tipe kelompok titik akhir. Nilai valid: default: kelompok titik akhir default. virtual: kelompok titik akhir virtual. Nilai kosong: mengkueri semua kelompok titik akhir default dan kelompok titik akhir virtual.	virtual
AccessLogSwitch	string	No	Apakah akan mengaktifkan pencatatan akses. Nilai valid: on: Mengaktifkan pencatatan akses. off (default): Menonaktifkan pencatatan akses.	on
EndpointGroupId	string	No	ID kelompok titik akhir.	epg-bp16jdc00bhe97sr5****
Tag	array<object>	No	Tag kelompok titik akhir.
	object	No	Tag kelompok titik akhir.
Key	string	No	Kunci tag kelompok titik akhir. Jika Anda menentukan parameter ini, nilainya tidak boleh berupa string kosong. Panjang kunci tag dapat mencapai 64 karakter dan tidak boleh diawali dengan `aliyun` atau `acs:`. Tidak boleh mengandung `http://` atau `https://`. Anda dapat menentukan hingga 20 kunci tag.	test-key
Value	string	No	Nilai tag kelompok titik akhir. Jika Anda menentukan parameter ini, nilainya dapat berupa string kosong. Panjang nilai tag dapat mencapai 128 karakter dan tidak boleh diawali dengan `aliyun` atau `acs:`. Tidak boleh mengandung `http://` atau `https://`. Anda dapat menentukan hingga 20 nilai tag.	test-value
EndpointGroupRegion	string	No

Elemen respons

Element	Type	Description	Example
	object	Daftar informasi yang dikembalikan.
TotalCount	integer	Jumlah total entri yang dikembalikan.	1
PageSize	integer	Jumlah entri per halaman dalam kueri penomoran halaman.	10
RequestId	string	ID permintaan.	A052D49E-CCC2-41DB-816C-DC3381503194
PageNumber	integer	Nomor halaman.	1
EndpointGroups	array<object>	Konfigurasi kelompok titik akhir.
	array<object>	Konfigurasi kelompok titik akhir.
EndpointGroupId	string	ID kelompok titik akhir.	epg-bp16jdc00bhe97sr5****
EndpointGroupIpList	array	Daftar alamat IP publik kelompok titik akhir. Penting Untuk kelompok titik akhir yang menggunakan back-to-origin jaringan pribadi, konsol hanya menampilkan alamat back-to-origin jaringan pribadi dan tidak lagi menampilkan alamat IP publik. Jika tipe konektivitas jaringan layanan backend berubah (misalnya, dari jaringan pribadi ke jaringan publik, atau ke kombinasi back-to-origin jaringan pribadi dan publik), segera periksa perubahan pada alamat back-to-origin dan perbarui ACL layanan backend secara sinkron sesuai kebutuhan.
	string	Daftar alamat IP publik kelompok titik akhir.	47.1.XX.XX
EndpointGroupUnconfirmedIpList	array	Daftar alamat IP kelompok titik akhir yang belum dikonfirmasi yang ditambahkan setelah instans Alibaba Cloud Akselerator Global (GA) ditingkatkan.
	string	Daftar alamat IP kelompok titik akhir yang belum dikonfirmasi yang ditambahkan setelah instans Alibaba Cloud Akselerator Global (GA) ditingkatkan.	47.1.XX.XX
State	string	Status kelompok titik akhir. Nilai valid: init: Kelompok titik akhir sedang diinisialisasi. active: Kelompok titik akhir berjalan sesuai harapan. updating: Kelompok titik akhir sedang diperbarui. deleteing: Kelompok titik akhir sedang dihapus.	active
HealthCheckPath	string	Jalur pemeriksaan kesehatan.	/healthcheck
EndpointGroupRegion	string	ID wilayah tempat kelompok titik akhir diterapkan.	cn-hangzhou
HealthCheckIntervalSeconds	integer	Interval antara dua pemeriksaan kesehatan berturut-turut. Unit: seconds.	3
TrafficPercentage	integer	Rasio trafik untuk kelompok titik akhir ketika pendengar dikaitkan dengan beberapa kelompok titik akhir.	100
HealthCheckProtocol	string	Protokol yang digunakan untuk pemeriksaan kesehatan. Nilai valid: tcp atau TCP: TCP. http atau HTTP: HTTP. https atau HTTPS: HTTPS.	tcp
ThresholdCount	integer	Jumlah kegagalan pemeriksaan kesehatan berturut-turut yang harus terjadi sebelum titik akhir dianggap tidak sehat.	3
ListenerId	string	ID instans pendengar.	lsr-bp1bpn0kn908w4nbw****
AcceleratorId	string	ID instans Alibaba Cloud Akselerator Global (GA).	ga-bp1odcab8tmno0hdq****
EndpointConfigurations	array<object>	Konfigurasi titik akhir.
	object	Konfigurasi titik akhir.
Type	string	Tipe titik akhir. Nilai valid: Domain: nama domain kustom. Ip: alamat IP kustom. IpTarget: IP pribadi kustom. PublicIp: alamat IP publik Alibaba Cloud. ECS: Instance ECS Alibaba Cloud. SLB: Instance SLB Alibaba Cloud. ALB: instans Alibaba Cloud ALB. OSS: instans Alibaba Cloud OSS. ENI: antarmuka jaringan elastis (ENI) Alibaba Cloud. NLB: instans Alibaba Cloud NLB.	Ip
EnableClientIPPreservation	boolean	Apakah pelestarian alamat IP klien diaktifkan menggunakan metode otomatis. Nilai valid: true: Pelestarian alamat IP klien diaktifkan. false: Pelestarian alamat IP klien dinonaktifkan.	false
Weight	integer	Bobot titik akhir.	20
ProbeProtocol	string	Protokol probe yang digunakan untuk pemantauan latensi. Nilai valid: icmp: ICMP. tcp: TCP.	tcp
Endpoint	string	The endpoint's IP address, domain name, or instance ID.	47.1.XX.XX
EnableProxyProtocol	boolean	Apakah pelestarian alamat IP klien diaktifkan menggunakan metode ProxyProtocol. Nilai valid: true: Pelestarian alamat IP klien diaktifkan menggunakan metode ProxyProtocol. false: Pelestarian alamat IP klien tidak diaktifkan menggunakan metode ProxyProtocol.
ProbePort	integer	Port probe yang digunakan untuk pemantauan latensi.	80
EndpointId	string	ID titik akhir.	ep-bp1d2utp8qqe2a44t****
SubAddress	string	IP pribadi antarmuka jaringan elastis (ENI).	172.168.XX.XX
VpcId	string	ID VPC.	vpc-8vbhucmd5b2q2fpqqu****
VSwitchIds	array	Daftar vSwitch di VPC.
	string	ID vSwitch.	vsw-hp3xwc2aebg2u30ln****
Provider	string	Informasi penyedia.	BAILIAN
ApiKeys	array	Kunci API dalam konfigurasi titik akhir.
	string	Kunci API pertama dalam kelompok titik akhir.	sk-*******
PortOverrides	array<object>	Informasi pemetaan port.
	object	Informasi pemetaan port.
ListenerPort	integer	Port pendengar.	443
EndpointPort	integer	Port titik akhir.	80
ForwardingRuleIds	array	ID aturan pengalihan yang dikaitkan dengan kelompok titik akhir.
	string	ID aturan pengalihan yang dikaitkan dengan kelompok titik akhir.	frule-bp19a3t3yzr21q3****
EndpointGroupType	string	Tipe kelompok titik akhir. Nilai valid: default: kelompok titik akhir default. virtual: kelompok titik akhir virtual.	default
EndpointRequestProtocol	string	Protokol layanan backend. Nilai valid: HTTP: HTTP. HTTPS: HTTPS.	HTTP
EndpointProtocolVersion	string	Versi protokol layanan backend. Nilai valid: HTTP1.1: HTTP 1.1. HTTP2: HTTP 2.	HTTP1.1
Description	string	Deskripsi kelompok titik akhir.	kelompok1
Name	string	Nama kelompok titik akhir.	kelompok1
HealthCheckPort	integer	Port yang digunakan untuk pemeriksaan kesehatan.	10
HealthCheckEnabled	boolean	Apakah pemeriksaan kesehatan diaktifkan. Nilai valid: true: Pemeriksaan kesehatan diaktifkan. false: Pemeriksaan kesehatan dinonaktifkan.	true
ServiceId	string	ID layanan yang mengelola instans terkelola. Catatan Parameter ini hanya valid ketika ServiceManaged diatur ke True.	ALB
ServiceManaged	boolean	Apakah instans dikelola. Nilai valid: true: Instans dikelola. false: Instans tidak dikelola.	true
ServiceManagedInfos	array<object>	Daftar kebijakan aksi yang dapat dieksekusi pengguna pada instans terkelola. Catatan Parameter ini hanya valid ketika ServiceManaged diatur ke True. Ketika instans dikelola, operasi pengguna pada instans dibatasi, dan aksi tertentu dilarang.
	object	Daftar kebijakan aksi yang dapat dieksekusi pengguna pada instans terkelola.
Action	string	Nama aksi kebijakan terkelola. Nilai valid: Create: membuat instans. Update: memperbarui instans saat ini. Delete: menghapus instans saat ini. Associate: mereferensikan atau direferensikan oleh instans saat ini. UserUnmanaged: membatalkan pengelolaan instans. CreateChild: membuat Sumber daya turunan di bawah instans saat ini.	Update
ChildType	string	Tipe Sumber daya turunan. Nilai valid: Listener: Sumber daya pendengar. IpSet: Sumber daya wilayah akselerasi. EndpointGroup: Sumber daya kelompok titik akhir. ForwardingRule: Sumber daya aturan pengalihan. Endpoint: Sumber daya titik akhir. EndpointGroupDestination: Sumber daya pemetaan protokol untuk kelompok titik akhir di bawah pendengar perutean kustom. EndpointPolicy: Sumber daya kebijakan trafik titik akhir di bawah pendengar perutean kustom. Catatan Parameter ini hanya valid ketika Action diatur ke CreateChild.	Listener
IsManaged	boolean	Apakah aksi kebijakan terkelola dikelola. Nilai valid: true: Aksi kebijakan terkelola dikelola. Pengguna tidak dapat melakukan aksi yang ditentukan oleh Action pada instans terkelola. false: Aksi kebijakan terkelola tidak dikelola. Pengguna dapat melakukan aksi yang ditentukan oleh Action pada instans terkelola.	false
Tags	array<object>	Tag kelompok titik akhir.
	object	Tag kelompok titik akhir.
Key	string	Kunci tag kelompok titik akhir.	test-key
Value	string	Nilai tag kelompok titik akhir.	test-value
HealthCheckHost	string	Nama domain yang digunakan untuk pemeriksaan kesehatan.	www.taobao.com
EndpointIpVersion	string	Versi protokol IP yang digunakan oleh layanan backend. Nilai valid: IPv4 (default): GA berkomunikasi dengan layanan titik akhir hanya menggunakan alamat IPv4. IPv6: GA berkomunikasi dengan layanan titik akhir hanya menggunakan alamat IPv6. ProtocolAffinity: Protokol IP yang digunakan GA untuk berkomunikasi dengan layanan titik akhir sama dengan protokol IP yang digunakan oleh permintaan klien.	IPv4
EndpointPrivateIpList	array<object>	Daftar alamat IP pribadi node backend.
	object
PrivateIp	string	Alamat IP pribadi.	172.19.115.37
VSwitchId	string	ID vSwitch di VPC.	gsw-0jl6tmriqep1ga***
CIDR	string
HealthCheckSuccessCodes	string
HealthCheckMethod	string
ProxyTunnel	object
ConnectAuthPrefix	string
ConnectAuthSuffix	string
ConnectSessionHashHdr	string
ConnectTunnelTimeout	integer
TunnelServerPort	integer
TunnelServerType	string
TunnelServer	string

Contoh

Respons sukses

JSONformat

{
  "TotalCount": 1,
  "PageSize": 10,
  "RequestId": "A052D49E-CCC2-41DB-816C-DC3381503194\t",
  "PageNumber": 1,
  "EndpointGroups": [
    {
      "EndpointGroupId": "epg-bp16jdc00bhe97sr5****",
      "EndpointGroupIpList": [
        "47.1.XX.XX"
      ],
      "EndpointGroupUnconfirmedIpList": [
        "47.1.XX.XX"
      ],
      "State": "active",
      "HealthCheckPath": "/healthcheck",
      "EndpointGroupRegion": "cn-hangzhou",
      "HealthCheckIntervalSeconds": 3,
      "TrafficPercentage": 100,
      "HealthCheckProtocol": "tcp",
      "ThresholdCount": 3,
      "ListenerId": "lsr-bp1bpn0kn908w4nbw****",
      "AcceleratorId": "ga-bp1odcab8tmno0hdq****",
      "EndpointConfigurations": [
        {
          "Type": "Ip",
          "EnableClientIPPreservation": false,
          "Weight": 20,
          "ProbeProtocol": "tcp",
          "Endpoint": "47.1.XX.XX",
          "EnableProxyProtocol": false,
          "ProbePort": 80,
          "EndpointId": "ep-bp1d2utp8qqe2a44t****",
          "SubAddress": "172.168.XX.XX",
          "VpcId": "vpc-8vbhucmd5b2q2fpqqu****",
          "VSwitchIds": [
            "vsw-hp3xwc2aebg2u30ln****"
          ],
          "Provider": "BAILIAN",
          "ApiKeys": [
            "sk-*******"
          ]
        }
      ],
      "PortOverrides": [
        {
          "ListenerPort": 443,
          "EndpointPort": 80
        }
      ],
      "ForwardingRuleIds": [
        "frule-bp19a3t3yzr21q3****"
      ],
      "EndpointGroupType": "default",
      "EndpointRequestProtocol": "HTTP",
      "EndpointProtocolVersion": "HTTP1.1",
      "Description": "group1",
      "Name": "group1",
      "HealthCheckPort": 10,
      "HealthCheckEnabled": true,
      "ServiceId": "ALB",
      "ServiceManaged": true,
      "ServiceManagedInfos": [
        {
          "Action": "Update",
          "ChildType": "Listener",
          "IsManaged": false
        }
      ],
      "Tags": [
        {
          "Key": "test-key",
          "Value": "test-value"
        }
      ],
      "HealthCheckHost": "www.taobao.com",
      "EndpointIpVersion": "IPv4",
      "EndpointPrivateIpList": [
        {
          "PrivateIp": "172.19.115.37",
          "VSwitchId": "gsw-0jl6tmriqep1ga***",
          "CIDR": ""
        }
      ],
      "HealthCheckSuccessCodes": "",
      "HealthCheckMethod": "",
      "ProxyTunnel": {
        "ConnectAuthPrefix": "",
        "ConnectAuthSuffix": "",
        "ConnectSessionHashHdr": "",
        "ConnectTunnelTimeout": 0,
        "TunnelServerPort": 0,
        "TunnelServerType": "",
        "TunnelServer": ""
      }
    }
  ]
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	NoPermission	No permissions.
500	UnknownError	An error occurred while processing your request. Please try again. If the error persists, please submit a ticket.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.