Gunakan ListEndpointGroups - Global Accelerator - Alibaba Cloud - Global Accelerator

Mengambil 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 tempat instans Global Accelerator dideploy. Tetapkan nilainya ke cn-hangzhou.	cn-hangzhou
PageNumber	integer	No	Nomor halaman. Nilai default: 1.	1
PageSize	integer	No	Jumlah entri per halaman. Nilai maksimum: 50. Nilai default: 10.	10
AcceleratorId	string	Yes	ID instans Global Accelerator.	ga-bp1odcab8tmno0hdq****
ListenerId	string	No	ID listener.	lsr-bp1bpn0kn908w4nbw****
EndpointGroupType	string	No	Tipe kelompok titik akhir. Nilai yang valid: default: kelompok titik akhir default. virtual: kelompok titik akhir virtual. Jika Anda tidak mengisi parameter ini, kedua jenis kelompok titik akhir (default dan virtual) akan dikembalikan.	virtual
AccessLogSwitch	string	No	Menentukan apakah log akses diaktifkan. Nilai yang valid: on: mengaktifkan log akses. off (default): menonaktifkan log akses.	on
EndpointGroupId	string	No	ID kelompok titik akhir.	epg-bp16jdc00bhe97sr5****
Tag	array<object>	No	Tag dari kelompok titik akhir. Anda dapat menentukan maksimal 20 tag.
	object	No	Sebuah tag.
Key	string	No	Kunci tag. Kunci tidak boleh berupa string kosong. Panjang kunci maksimal 64 karakter dan tidak boleh diawali dengan `aliyun` atau `acs:`. Kunci juga tidak boleh mengandung `http://` atau `https://`.	test-key
Value	string	No	Nilai tag. Nilai dapat berupa string kosong. Panjang nilai maksimal 128 karakter dan tidak boleh diawali dengan `aliyun` atau `acs:`. Nilai juga tidak boleh mengandung `http://` atau `https://`.	test-value

Elemen respons

Element	Type	Description	Example
	object	Data respons.
TotalCount	integer	Total jumlah entri yang dikembalikan.	1
PageSize	integer	Jumlah entri per 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 egress publik dari kelompok titik akhir.
	string	Alamat IP egress publik dari kelompok titik akhir.	47.1.XX.XX
EndpointGroupUnconfirmedIpList	array	Alamat IP baru dalam kelompok titik akhir yang memerlukan konfirmasi setelah peningkatan instans Global Accelerator.
	string	Alamat IP baru dalam kelompok titik akhir yang memerlukan konfirmasi setelah peningkatan instans Global Accelerator.	47.1.XX.XX
State	string	Status kelompok titik akhir. Nilai yang valid: init: Kelompok titik akhir sedang diinisialisasi. active: Kelompok titik akhir stabil. updating: Kelompok titik akhir sedang diperbarui. deleting: Kelompok titik akhir sedang dihapus.	active
HealthCheckPath	string	Jalur pemeriksaan kesehatan.	/healthcheck
EndpointGroupRegion	string	ID wilayah tempat kelompok titik akhir dideploy.	cn-hangzhou
HealthCheckIntervalSeconds	integer	Interval pemeriksaan kesehatan, dalam detik.	3
TrafficPercentage	integer	Persentase trafik yang didistribusikan ke kelompok titik akhir. Parameter ini hanya berlaku jika listener dikaitkan dengan beberapa kelompok titik akhir.	100
HealthCheckProtocol	string	Protokol yang digunakan untuk pemeriksaan kesehatan. Nilai yang valid: tcp atau TCP: TCP http atau HTTP: HTTP https atau HTTPS: HTTPS	tcp
ThresholdCount	integer	Jumlah pemeriksaan kesehatan gagal berturut-turut sebelum sebuah titik akhir ditandai sebagai tidak sehat.	3
ListenerId	string	ID listener.	lsr-bp1bpn0kn908w4nbw****
AcceleratorId	string	ID instans Global Accelerator.	ga-bp1odcab8tmno0hdq****
EndpointConfigurations	array<object>	Konfigurasi titik akhir.
	object	Konfigurasi titik akhir.
Type	string	Tipe titik akhir. Nilai yang valid: Domain: Nama domain kustom. Ip: Alamat IP kustom. IpTarget: Alamat IP pribadi. PublicIp: Alamat IP publik Alibaba Cloud. ECS: Instance ECS Alibaba Cloud. SLB: Instance SLB Alibaba Cloud. ALB: Instance ALB Alibaba Cloud. OSS: Bucket OSS Alibaba Cloud. ENI: Antarmuka jaringan elastis Alibaba Cloud. NLB: Instance NLB Alibaba Cloud.	Ip
EnableClientIPPreservation	boolean	Menunjukkan apakah pelestarian IP klien diaktifkan. Nilai yang valid: true: Pelestarian IP klien diaktifkan. false: Pelestarian IP klien dinonaktifkan.	false
Weight	integer	Bobot titik akhir.	20
ProbeProtocol	string	Protokol yang digunakan untuk probe pemantauan latensi. Nilai yang valid: icmp: ICMP tcp: TCP	tcp
Endpoint	string	Alamat IP, nama domain, atau ID instans titik akhir.	47.1.XX.XX
EnableProxyProtocol	boolean	Menunjukkan apakah protokol proxy digunakan untuk melestarikan alamat IP klien. Nilai yang valid: true: Protokol proxy diaktifkan. false: Protokol proxy dinonaktifkan.
ProbePort	integer	Port yang digunakan untuk probe pemantauan latensi.	80
EndpointId	string	ID titik akhir.	ep-bp1d2utp8qqe2a44t****
SubAddress	string	Alamat IP pribadi dari antarmuka jaringan elastis.	172.168.XX.XX
VpcId	string	ID VPC.	vpc-8vbhucmd5b2q2fpqqu****
VSwitchIds	array	Daftar vSwitch di dalam VPC.
	string	ID vSwitch.	vsw-hp3xwc2aebg2u30ln****
Provider	string		BAILIAN
ApiKeys	array
	string		sk-*******
PortOverrides	array<object>	Pemetaan port.
	object	Pemetaan port.
ListenerPort	integer	Port listener.	443
EndpointPort	integer	Port titik akhir.	80
ForwardingRuleIds	array	ID aturan pengalihan yang terkait dengan kelompok titik akhir.
	string	ID aturan pengalihan yang terkait dengan kelompok titik akhir.	frule-bp19a3t3yzr21q3****
EndpointGroupType	string	Tipe kelompok titik akhir. Nilai yang valid: default: kelompok titik akhir default. virtual: kelompok titik akhir virtual.	default
EndpointRequestProtocol	string	Protokol layanan backend. Nilai yang valid: HTTP: HTTP HTTPS: HTTPS	HTTP
EndpointProtocolVersion	string	Versi protokol layanan backend. Nilai yang valid: HTTP1.1: HTTP/1.1 HTTP2: HTTP/2	HTTP1.1
Description	string	Deskripsi kelompok titik akhir.	group1
Name	string	Nama kelompok titik akhir.	group1
HealthCheckPort	integer	Port yang digunakan untuk pemeriksaan kesehatan.	10
HealthCheckEnabled	boolean	Menunjukkan apakah pemeriksaan kesehatan diaktifkan. Nilai yang valid: true: Pemeriksaan kesehatan diaktifkan. false: Pemeriksaan kesehatan dinonaktifkan.	true
ServiceId	string	ID layanan yang mengelola instans. Catatan Parameter ini hanya dikembalikan jika ServiceManaged diatur ke true.	ALB
ServiceManaged	boolean	Menunjukkan apakah instans merupakan instans terkelola. Nilai yang valid: true: Instans merupakan instans terkelola. false: Instans bukan instans terkelola.	true
ServiceManagedInfos	array<object>	Aksi yang dapat Anda lakukan pada instans terkelola. Catatan Parameter ini hanya dikembalikan jika ServiceManaged diatur ke true. Saat instans dikelola, izin Anda dibatasi, dan beberapa operasi dilarang.
	object	Aksi yang dapat Anda lakukan pada instans terkelola.
Action	string	Nama aksi pada instans terkelola. Nilai yang valid: Create: Membuat instans. Update: Memperbarui instans. Delete: Menghapus instans. Associate: Mengaitkan instans dengan sumber daya lain. UserUnmanaged: Menghentikan pengelolaan instans. CreateChild: Membuat sumber daya anak untuk instans.	Update
ChildType	string	Tipe sumber daya anak. Nilai yang valid: Listener: listener. IpSet: wilayah akselerasi. EndpointGroup: kelompok titik akhir. ForwardingRule: aturan pengalihan. Endpoint: titik akhir. EndpointGroupDestination: pemetaan protokol untuk kelompok titik akhir listener routing kustom. EndpointPolicy: kebijakan trafik untuk titik akhir listener routing kustom. Catatan Parameter ini hanya dikembalikan jika Action diatur ke CreateChild.	Listener
IsManaged	boolean	Menunjukkan apakah aksi tersebut dikelola. Nilai yang valid: true: Aksi dikelola. Anda tidak dapat melakukan aksi yang ditentukan pada instans terkelola. false: Aksi tidak dikelola. Anda dapat melakukan aksi yang ditentukan pada instans terkelola.	false
Tags	array<object>	Tag yang dilampirkan pada kelompok titik akhir.
	object	Tag dari kelompok titik akhir.
Key	string	Kunci tag.	test-key
Value	string	Nilai tag.	test-value
HealthCheckHost	string	Nama domain yang digunakan untuk pemeriksaan kesehatan.	www.taobao.com
EndpointIpVersion	string	Protokol IP yang digunakan untuk menghubungkan ke titik akhir. Nilai yang valid: IPv4 (default): Menghubungkan ke titik akhir menggunakan alamat IPv4. IPv6: Menghubungkan ke titik akhir menggunakan alamat IPv6. ProtocolAffinity: Menghubungkan ke titik akhir menggunakan protokol IP yang sama dengan klien.	IPv4
EndpointPrivateIpList	array<object>	Daftar alamat IP pribadi dari titik akhir.
	object
PrivateIp	string	Alamat IP pribadi.	172.19.115.37
VSwitchId	string	ID vSwitch di dalam VPC.	gsw-0jl6tmriqep1ga***
CIDR	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": ""
        }
      ]
    }
  ]
}

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.