All Products
Search

This Product

    Global Accelerator:ListEndpointGroups

    Document Center

    Global Accelerator:ListEndpointGroups

    Last Updated:Oct 13, 2026

    Mengkueri 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 None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    Yes

    ID wilayah instans Alibaba Cloud Akselerator Global (GA). Hanya cn-hangzhou yang didukung.

    cn-hangzhou
    PageNumber

    integer

    No

    Nomor halaman. Nilai default: 1.

    1
    PageSize

    integer

    No

    Jumlah entri yang dikembalikan per halaman dalam kueri penomoran halaman. 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: semua kelompok titik akhir default dan virtual.

    Valid values:

    • default :

      Kelompok titik akhir default.

    • virtual :

      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. Kunci tag tidak boleh berupa string kosong.

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

    Anda dapat menentukan hingga 20 kunci tag.

    test-key
    Value

    string

    No

    Nilai tag kelompok titik akhir. Nilai tag dapat berupa string kosong.

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

    Anda dapat menentukan hingga 20 nilai tag.

    test-value
    EndpointGroupRegion

    string

    No

    ID wilayah kelompok titik akhir yang digunakan untuk penyaringan.

    cn-hangzhou

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Daftar informasi tanggapan.

    TotalCount

    integer

    Jumlah total entri.

    1
    PageSize

    integer

    Jumlah entri yang dikembalikan per halaman.

    10
    RequestId

    string

    ID permintaan.

    A052D49E-CCC2-41DB-816C-DC3381503194

    PageNumber

    integer

    Nomor halaman.

    1
    EndpointGroups

    array<object>

    Informasi konfigurasi kelompok titik akhir.

    array<object>

    Informasi konfigurasi kelompok titik akhir.

    EndpointGroupId

    string

    ID kelompok titik akhir.

    epg-bp16jdc00bhe97sr5****
    EndpointGroupIpList

    array

    Daftar alamat IP publik arah keluar untuk kelompok titik akhir.

    Penting Untuk kelompok titik akhir yang menggunakan routing back-to-origin jaringan pribadi, konsol hanya menampilkan alamat back-to-origin pribadi dan tidak lagi menampilkan alamat publik. Jika tipe konektivitas jaringan layanan backend di kelompok titik akhir berubah (misalnya, dari jaringan pribadi ke jaringan publik, atau ke routing back-to-origin hibrida publik dan pribadi), perhatikan perubahan alamat back-to-origin dan perbarui daftar ACL layanan backend secara sinkron.

    string

    Alamat IP publik arah keluar kelompok titik akhir.

    47.1.XX.XX
    EndpointGroupUnconfirmedIpList

    array

    Daftar alamat IP kelompok titik akhir baru yang menunggu konfirmasi setelah Instans Alibaba Cloud Akselerator Global (GA) ditingkatkan.

    string

    Daftar alamat IP kelompok titik akhir baru yang menunggu konfirmasi setelah Instans Alibaba Cloud Akselerator Global (GA) ditingkatkan.

    47.1.XX.XX
    State

    string

    Status kelompok titik akhir.

    • init: Menginisialisasi.

    • active: Normal.

    • updating: Memperbarui.

    • deleteing: Menghapus.

    active
    HealthCheckPath

    string

    Jalur pemeriksaan kesehatan.

    /healthcheck
    EndpointGroupRegion

    string

    ID wilayah tempat kelompok titik akhir berada.

    cn-hangzhou
    HealthCheckIntervalSeconds

    integer

    Interval antara pemeriksaan kesehatan. Unit: seconds.

    3
    TrafficPercentage

    integer

    Persentase trafik yang dialihkan ke kelompok titik akhir ketika pendengar dikaitkan dengan beberapa kelompok titik akhir.

    100
    HealthCheckProtocol

    string

    Protokol pemeriksaan kesehatan.

    • tcp atau TCP: TCP.

    • http atau HTTP: HTTP.

    • https atau HTTPS: HTTPS.

    tcp
    ThresholdCount

    integer

    Jumlah pemeriksaan kesehatan gagal berturut-turut sebelum titik akhir dinyatakan tidak sehat.

    3
    ListenerId

    string

    ID Instans pendengar.

    lsr-bp1bpn0kn908w4nbw****
    AcceleratorId

    string

    ID Instans Alibaba Cloud Akselerator Global (GA).

    ga-bp1odcab8tmno0hdq****
    EndpointConfigurations

    array<object>

    Informasi konfigurasi titik akhir.

    object

    Informasi konfigurasi titik akhir.

    Type

    string

    Tipe titik akhir.

    • Domain: Nama domain kustom.

    • Ip: Alamat IP kustom.

    • IpTarget: Alamat IP pribadi kustom.

    • PublicIp: Alamat IP publik Alibaba Cloud.

    • ECS: Instance ECS.

    • SLB: Instance SLB.

    • ALB: Instans ALB.

    • OSS: Instans OSS.

    • ENI: Antarmuka jaringan elastis (ENI) Alibaba Cloud.

    • NLB: Instans NLB.

    Ip
    EnableClientIPPreservation

    boolean

    Apakah akan mengaktifkan fitur preservasi alamat IP klien menggunakan metode pengambilan otomatis.

    • true: Fitur preservasi alamat IP klien diaktifkan.

    • false: Fitur preservasi alamat IP klien dinonaktifkan.

    false
    Weight

    integer

    Bobot titik akhir.

    20
    ProbeProtocol

    string

    Protokol probing untuk pemantauan latensi.

    • icmp: ICMP.

    • tcp: TCP.

    tcp
    Endpoint

    string

    Alamat IP, nama domain, atau ID instans titik akhir.

    47.1.XX.XX
    EnableProxyProtocol

    boolean

    Apakah akan mengaktifkan fitur preservasi alamat IP klien menggunakan Protokol Proxy.

    • true: Fitur preservasi alamat IP klien diaktifkan menggunakan Protokol Proxy.

    • false: Fitur preservasi alamat IP klien tidak diaktifkan menggunakan Protokol Proxy.

    ProbePort

    integer

    Port probing untuk pemantauan latensi.

    80
    EndpointId

    string

    ID titik akhir.

    ep-bp1d2utp8qqe2a44t****
    SubAddress

    string

    Alamat 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>

    Pemetaan port.

    object

    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.

    • default: Kelompok titik akhir default.

    • virtual: Kelompok titik akhir virtual.

    default
    EndpointRequestProtocol

    string

    Protokol layanan backend.

    • HTTP: HTTP.

    • HTTPS: HTTPS.

    HTTP
    EndpointProtocolVersion

    string

    Versi protokol layanan backend.

    • HTTP1.1: HTTP1.1.

    • HTTP2: HTTP2.

    HTTP1.1
    Description

    string

    Deskripsi kelompok titik akhir.

    group1
    Name

    string

    Nama kelompok titik akhir.

    group1
    HealthCheckPort

    integer

    Port pemeriksaan kesehatan.

    10
    HealthCheckEnabled

    boolean

    Apakah akan mengaktifkan pemeriksaan kesehatan.

    • true: Pemeriksaan kesehatan diaktifkan.

    • false: Pemeriksaan kesehatan dinonaktifkan.

    true
    ServiceId

    string

    ID penyedia layanan tempat instans terkelola berada.

    Catatan

    Parameter ini hanya valid ketika parameter ServiceManaged diatur ke true.

    ALB
    ServiceManaged

    boolean

    Apakah instance merupakan instans terkelola. Nilai valid:

    • true: Instance merupakan instans terkelola.

    • false: Instance bukan instans terkelola.

    true
    ServiceManagedInfos

    array<object>

    Daftar kebijakan tindakan yang dapat dieksekusi pengguna pada Instans terkelola ini.

    Catatan

    • Parameter ini hanya valid ketika parameter ServiceManaged diatur ke true.

    • Ketika Instans berada dalam status terkelola, operasi pengguna pada Instans dibatasi, dan operasi tertentu dilarang.

    object

    Kebijakan tindakan yang dapat dieksekusi pengguna pada Instans terkelola.

    Action

    string

    Nama aksi kebijakan terkelola.

    • 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.

    • 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 kelompok titik akhir di bawah pendengar routing kustom.

    • EndpointPolicy: Sumber daya kebijakan akses titik akhir di bawah pendengar routing kustom.

    Catatan

    Parameter ini hanya valid ketika parameter Action diatur ke CreateChild.

    Listener
    IsManaged

    boolean

    Apakah aksi kebijakan terkelola dikelola. Nilai valid:

    • true: Aksi kebijakan terkelola dikelola. Pengguna tidak memiliki izin untuk melakukan operasi yang ditentukan oleh Action pada instans terkelola.

    • false: Aksi kebijakan terkelola tidak dikelola. Pengguna dapat melakukan operasi 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 pemeriksaan kesehatan.

    www.taobao.com
    EndpointIpVersion

    string

    Protokol alamat IP backend. Nilai valid:

    • IPv4: (default) GA hanya menggunakan alamat IPv4 untuk berkomunikasi dengan layanan titik akhir.

    • IPv6: GA hanya menggunakan alamat IPv6 untuk berkomunikasi dengan layanan titik akhir.

    • 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

    Blok CIDR yang dikaitkan dengan alamat IP pribadi.

    10.0.0.0/24
    HealthCheckSuccessCodes

    string

    Kumpulan kode status yang menunjukkan pemeriksaan kesehatan berhasil.

    http_2xx,http_3xx
    HealthCheckMethod

    string

    Metode permintaan HTTP yang digunakan untuk pemeriksaan kesehatan.

    GET
    ProxyTunnel

    object

    Konfigurasi saluran data proxy.

    ConnectAuthPrefix

    string

    Awalan otentikasi koneksi saluran data proxy.

    prefix-auth
    ConnectAuthSuffix

    string

    Akhiran otentikasi koneksi saluran data proxy.

    suffix-auth
    ConnectSessionHashHdr

    string

    Nama header permintaan yang digunakan untuk penghashan sesi.

    X-Session-Hash
    ConnectTunnelTimeout

    integer

    Periode waktu tunggu koneksi saluran data proxy. Unit: milliseconds.

    5000
    TunnelServerPort

    integer

    Port server saluran data.

    8443
    TunnelServerType

    string

    Tipe alamat server saluran data. Nilai valid: ip (alamat IPv4) dan domain (nama domain).

    domain
    TunnelServer

    string

    Alamat IPv4 atau nama domain server saluran data.

    tunnel.example.com

    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": "10.0.0.0/24"
        }
      ],
      "HealthCheckSuccessCodes": "http_2xx,http_3xx",
      "HealthCheckMethod": "GET",
      "ProxyTunnel": {
        "ConnectAuthPrefix": "prefix-auth",
        "ConnectAuthSuffix": "suffix-auth",
        "ConnectSessionHashHdr": "X-Session-Hash",
        "ConnectTunnelTimeout": 5000,
        "TunnelServerPort": 8443,
        "TunnelServerType": "domain",
        "TunnelServer": "tunnel.example.com"
      }
    }
  ]
}

    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.