Gunakan DescribeEndpointGroup untuk mengkueri detail grup endpoint - Global Accelerator

Mengembalikan detail kelompok titik akhir yang ditentukan.

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

get

*EndpointGroup

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

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	ID wilayah instans Alibaba Cloud Global Accelerator (GA). Tetapkan nilainya ke cn-hangzhou.	cn-hangzhou
EndpointGroupId	string	Yes	ID kelompok titik akhir yang akan dikueri.	epg-bp14sz7ftcwwjgrdm****

Elemen respons

Element	Type	Description	Example
	object	Informasi yang dikembalikan.
HealthCheckIntervalSeconds	integer	Interval pemeriksaan kesehatan dilakukan. Satuan: detik.	3
TrafficPercentage	integer	Persentase traffic yang didistribusikan ke kelompok titik akhir ketika sebuah listener dikaitkan dengan beberapa kelompok titik akhir.	100
EndpointGroupId	string	ID kelompok titik akhir.	epg-bp14sz7ftcwwjgrdm****
Description	string	Deskripsi kelompok titik akhir.	group1
EndpointGroupIpList	array	Daftar alamat IP titik akhir aktif dalam kelompok titik akhir.
	string	Daftar alamat IP titik akhir aktif dalam kelompok titik akhir.	101.XX.XX.22
EndpointGroupUnconfirmedIpList	array	Daftar alamat IP titik akhir dalam kelompok titik akhir yang menunggu konfirmasi setelah instans GA ditingkatkan.
	string	Daftar alamat IP titik akhir dalam kelompok titik akhir yang menunggu konfirmasi setelah instans GA ditingkatkan.	101.XX.XX.22
RequestId	string	ID permintaan.	6FEA0CF3-D3B9-43E5-A304-D217037876A8
HealthCheckPath	string	Jalur untuk pemeriksaan kesehatan.	/healthcheck
ThresholdCount	integer	Jumlah kegagalan pemeriksaan kesehatan berturut-turut yang harus terjadi sebelum sebuah titik akhir dianggap tidak sehat.	3
Name	string	Nama kelompok titik akhir.	group1
EndpointGroupRegion	string	ID wilayah tempat kelompok titik akhir ditempatkan.	cn-hangzhou
State	string	Status kelompok titik akhir. init: Kelompok titik akhir sedang diinisialisasi. active: Kelompok titik akhir aktif. updating: Kelompok titik akhir sedang diperbarui. deleting: Kelompok titik akhir sedang dihapus.	active
HealthCheckProtocol	string	Protokol untuk pemeriksaan kesehatan. tcp atau TCP: TCP. http atau HTTP: HTTP. https atau HTTPS: HTTPS.	tcp
HealthCheckPort	integer	Port yang digunakan untuk pemeriksaan kesehatan.	20
EndpointConfigurations	array<object>	Konfigurasi titik akhir.
	object	Konfigurasi titik akhir.
Type	string	Jenis titik akhir. Domain: nama domain kustom. Ip: alamat IP kustom. IpTarget: alamat IP pribadi kustom. PublicIp: alamat IP publik Alibaba Cloud. ECS: instans Alibaba Cloud Elastic Compute Service (ECS). SLB: instans Alibaba Cloud Server Load Balancer (SLB). ALB: instans Alibaba Cloud Application Load Balancer (ALB). OSS: bucket Alibaba Cloud Object Storage Service (OSS). ENI: antarmuka jaringan elastis (ENI) Alibaba Cloud. NLB: instans Alibaba Cloud Network Load Balancer (NLB).	Ip
EnableClientIPPreservation	boolean	Menunjukkan apakah pelestarian alamat IP klien diaktifkan. true: Pelestarian alamat IP klien diaktifkan. false: Pelestarian alamat IP klien dinonaktifkan.	false
Weight	integer	Bobot titik akhir.	255
ProbeProtocol	string	Protokol yang digunakan untuk probe latensi. tcp: TCP. icmp: ICMP.	tcp
Endpoint	string	Alamat IP, nama domain, atau ID instans titik akhir.	120.XX.XX.21
EnableProxyProtocol	boolean	Menunjukkan apakah Proxy Protocol digunakan untuk melestarikan alamat IP klien. true: Proxy Protocol digunakan untuk melestarikan alamat IP klien. false: Proxy Protocol tidak digunakan untuk melestarikan alamat IP klien.	false
ProbePort	integer	Port yang digunakan untuk probe latensi.	80
SubAddress	string	Alamat IP pribadi ENI.	172.168.XX.XX
VpcId	string	ID virtual private cloud (VPC).	vpc-hp30gtnxkfxj1l2xt****
VSwitchIds	array	Daftar vSwitch dalam VPC.
	string	ID vSwitch.	vsw-bp1nx4sxxe1nnr1ja****
PortOverrides	array<object>	Pemetaan port.
	object	Pemetaan port.
ListenerPort	integer	Port listener.	443
EndpointPort	integer	Port titik akhir.	80
EndpointRequestProtocol	string	Protokol layanan backend. HTTP HTTPS	HTTP
EndpointProtocolVersion	string	Versi protokol layanan backend. HTTP1.1 HTTP2
EndpointGroupType	string	Jenis kelompok titik akhir. default: kelompok titik akhir default. virtual: kelompok titik akhir virtual.	default
ForwardingRuleIds	array	ID aturan pengalihan yang dikaitkan dengan kelompok titik akhir.
	string	ID aturan pengalihan yang dikaitkan dengan kelompok titik akhir.	frule-bp19a3t3yzr21q3****
AcceleratorId	string	ID instans GA.	ga-bp1odcab8tmno0hdq****
ListenerId	string	ID listener.	lsr-bp1bpn0kn908w4nbw****
SlsRegion	string	Wilayah proyek Simple Log Service (SLS).	cn-hangzhou
SlsProjectName	string	Nama proyek SLS.	pn-01
SlsLogStoreName	string	Nama penyimpanan log SLS.	lsn-01
AccessLogSwitch	string	Status fitur log akses. on: diaktifkan. off: dinonaktifkan. binding: sedang diaktifkan. unbinding: sedang dinonaktifkan.	on
EnableAccessLog	boolean	Menunjukkan apakah pencatatan log akses diaktifkan. true: Pencatatan log akses diaktifkan. false: Pencatatan log akses dinonaktifkan.	true
HealthCheckEnabled	boolean	Menunjukkan apakah pemeriksaan kesehatan diaktifkan. 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 tersebut dikelola. true: Instans tersebut dikelola. false: Instans tersebut tidak dikelola.	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, Anda tidak dapat melakukan beberapa operasi pada instans tersebut.
	object	Aksi yang dapat Anda lakukan pada instans terkelola.
Action	string	Nama aksi pada instans terkelola. Create: membuat instans. Update: memperbarui instans saat ini. Delete: menghapus instans saat ini. Associate: mengaitkan instans dengan sumber daya lain. UserUnmanaged: memutuskan kaitan instans dari layanan. CreateChild: membuat sumber daya anak dalam instans.	Update
ChildType	string	Jenis sumber daya anak. Listener: listener. IpSet: wilayah akselerasi. EndpointGroup: kelompok titik akhir. ForwardingRule: aturan pengalihan. Endpoint: titik akhir. EndpointGroupDestination: pemetaan protokol kelompok titik akhir yang dikaitkan dengan listener routing kustom. EndpointPolicy: kebijakan traffic titik akhir yang dikaitkan dengan listener routing kustom. Catatan Parameter ini hanya dikembalikan jika Action diatur ke CreateChild.	Listener
IsManaged	boolean	Menunjukkan apakah aksi yang ditentukan dikelola. true: Aksi yang ditentukan dikelola. Anda tidak dapat melakukan aksi tersebut pada instans terkelola. false: Aksi yang ditentukan tidak dikelola. Anda dapat melakukan aksi tersebut 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

Contoh

Respons sukses

JSONformat

{
  "HealthCheckIntervalSeconds": 3,
  "TrafficPercentage": 100,
  "EndpointGroupId": "epg-bp14sz7ftcwwjgrdm****",
  "Description": "group1",
  "EndpointGroupIpList": [
    "101.XX.XX.22"
  ],
  "EndpointGroupUnconfirmedIpList": [
    "101.XX.XX.22"
  ],
  "RequestId": "6FEA0CF3-D3B9-43E5-A304-D217037876A8\t",
  "HealthCheckPath": "/healthcheck",
  "ThresholdCount": 3,
  "Name": "group1",
  "EndpointGroupRegion": "cn-hangzhou",
  "State": "active",
  "HealthCheckProtocol": "tcp",
  "HealthCheckPort": 20,
  "EndpointConfigurations": [
    {
      "Type": "Ip",
      "EnableClientIPPreservation": false,
      "Weight": 255,
      "ProbeProtocol": "tcp",
      "Endpoint": "120.XX.XX.21",
      "EnableProxyProtocol": false,
      "ProbePort": 80,
      "SubAddress": "172.168.XX.XX",
      "VpcId": "vpc-hp30gtnxkfxj1l2xt****",
      "VSwitchIds": [
        "vsw-bp1nx4sxxe1nnr1ja****"
      ]
    }
  ],
  "PortOverrides": [
    {
      "ListenerPort": 443,
      "EndpointPort": 80
    }
  ],
  "EndpointRequestProtocol": "HTTP",
  "EndpointProtocolVersion": "",
  "EndpointGroupType": "default",
  "ForwardingRuleIds": [
    "frule-bp19a3t3yzr21q3****"
  ],
  "AcceleratorId": "ga-bp1odcab8tmno0hdq****",
  "ListenerId": "lsr-bp1bpn0kn908w4nbw****",
  "SlsRegion": "cn-hangzhou",
  "SlsProjectName": "pn-01",
  "SlsLogStoreName": "lsn-01",
  "AccessLogSwitch": "on",
  "EnableAccessLog": true,
  "HealthCheckEnabled": true,
  "ServiceId": "ALB",
  "ServiceManaged": true,
  "ServiceManagedInfos": [
    {
      "Action": "Update",
      "ChildType": "Listener",
      "IsManaged": false
    }
  ],
  "Tags": [
    {
      "Key": "test-key",
      "Value": "test-value"
    }
  ],
  "HealthCheckHost": ""
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
500	UnknownError	An error occurred while processing your request. Please try again. If the error persists, please submit a ticket.	An error occurred while the request was being processed. Try again later.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.