Tüm Ürünler
Search

Bu Ürün

    :ListEndpointGroups

    Belge Merkezi

    :ListEndpointGroups

    Son Güncelleme:Oct 13, 2026

    Uç nokta gruplarını sorgular.

    Try it now

    Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

    Test

    RAM authorization

    The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

    • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

    • API: The API that you can call to perform the action.

    • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

    • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

      • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

      • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

    • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

    • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    ga:ListEndpointGroups

    list

    *EndpointGroup.

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

    		 None None

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    Yes

    Alibaba Cloud Global Accelerator (GA) örneğinin bölge kimliği. Yalnızca cn-hangzhou desteklenir.

    cn-hangzhou
    PageNumber

    integer

    No

    Sayfa numarası. Varsayılan değer: 1.

    1
    PageSize

    integer

    No

    Sayfalı sorguda sayfa başına döndürülecek giriş sayısı. Maksimum değer: 50. Varsayılan değer: 10.

    10
    AcceleratorId

    string

    Yes

    Alibaba Cloud Global Accelerator (GA) örneğinin kimliği.

    ga-bp1odcab8tmno0hdq****
    ListenerId

    string

    No

    Dinleyici örneğinin kimliği.

    lsr-bp1bpn0kn908w4nbw****
    EndpointGroupType

    string

    No

    Uç nokta grubunun türü. Geçerli değerler:

    • default: varsayılan uç nokta grubu.

    • virtual: sanal uç nokta grubu.

    • Boş değer: tüm varsayılan ve sanal uç nokta grupları.

    Valid values:

    • default :

      Varsayılan uç nokta grubu.

    • virtual :

      Sanal uç nokta grubu.

    virtual
    AccessLogSwitch

    string

    No

    Erişim günlüğünün etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:

    • on: erişim günlüğünü etkinleştirir.

    • off (varsayılan): erişim günlüğünü devre dışı bırakır.

    on
    EndpointGroupId

    string

    No

    Uç nokta grubunun kimliği.

    epg-bp16jdc00bhe97sr5****
    Tag

    array<object>

    No

    Uç nokta grubunun etiketleri.

    object

    No

    Uç nokta grubunun etiketleri.

    Key

    string

    No

    Uç nokta grubunun etiket anahtarı. Etiket anahtarı boş bir dize olamaz.

    Etiket anahtarı en fazla 64 karakter uzunluğunda olabilir ve aliyun veya acs: ile başlayamaz. http:// veya https:// içeremez.

    En fazla 20 etiket anahtarı belirtebilirsiniz.

    test-key
    Value

    string

    No

    Uç nokta grubunun etiket değeri. Etiket değeri boş bir dize olabilir.

    Etiket değeri en fazla 128 karakter uzunluğunda olabilir ve aliyun veya acs: ile başlayamaz. http:// veya https:// içeremez.

    En fazla 20 etiket değeri belirtebilirsiniz.

    test-value
    EndpointGroupRegion

    string

    No

    Filtreleme için kullanılan uç nokta grubunun bölge kimliği.

    cn-hangzhou

    Response elements

    Element

    Type

    Description

    Example

    object

    Yanıt bilgileri listesi.

    TotalCount

    integer

    Toplam giriş sayısı.

    1
    PageSize

    integer

    Sayfa başına döndürülen giriş sayısı.

    10
    RequestId

    string

    İstek kimliği.

    A052D49E-CCC2-41DB-816C-DC3381503194

    PageNumber

    integer

    Sayfa numarası.

    1
    EndpointGroups

    array<object>

    Uç nokta grubu yapılandırma bilgileri.

    array<object>

    Uç nokta grubu yapılandırma bilgileri.

    EndpointGroupId

    string

    Uç nokta grubunun kimliği.

    epg-bp16jdc00bhe97sr5****
    EndpointGroupIpList

    array

    Uç nokta grubu için giden genel IP adresleri listesi.

    Önemli Özel ağ kaynağa dönüş yönlendirmesi kullanan uç nokta grupları için konsol yalnızca özel kaynağa dönüş adreslerini görüntüler ve artık genel adresleri görüntülemez. Uç nokta grubundaki arka uç hizmetinin ağ bağlantı türü değişirse (örneğin, özel ağdan genel ağa veya hibrit genel ve özel ağ kaynağa dönüş yönlendirmesine), kaynağa dönüş adreslerindeki değişikliklere çok dikkat edin ve arka uç hizmetinin ACL listesini senkronize bir şekilde güncelleyin.

    string

    Uç nokta grubunun giden genel IP adresı.

    47.1.XX.XX
    EndpointGroupUnconfirmedIpList

    array

    Alibaba Cloud Global Accelerator (GA) örneği yükseltildikten sonra onay bekleyen yeni uç nokta grubu IP adresları listesi.

    string

    Alibaba Cloud Global Accelerator (GA) örneği yükseltildikten sonra onay bekleyen yeni uç nokta grubu IP adresları listesi.

    47.1.XX.XX
    State

    string

    Uç nokta grubunun durumu.

    • init: Başlatılıyor.

    • active: Normal.

    • updating: Güncelleniyor.

    • deleteing: Siliniyor.

    active
    HealthCheckPath

    string

    Sağlık kontrolü yolu.

    /healthcheck
    EndpointGroupRegion

    string

    Uç nokta grubunun ait olduğu bölgenin kimliği.

    cn-hangzhou
    HealthCheckIntervalSeconds

    integer

    Sağlık kontrolleri arasındaki aralık. Birim: saniye.

    3
    TrafficPercentage

    integer

    Bir dinleyici birden fazla uç nokta grubuyla ilişkilendirildiğinde uç nokta grubuna yönlendirilen trafik yüzdesi.

    100
    HealthCheckProtocol

    string

    Sağlık kontrolü protokolü.

    • tcp veya TCP: TCP.

    • http veya HTTP: HTTP.

    • https veya HTTPS: HTTPS.

    tcp
    ThresholdCount

    integer

    Bir uç nokta sağlıksız olarak ilan edilmeden önceki ardışık başarısız sağlık kontrolü sayısı.

    3
    ListenerId

    string

    Dinleyici örnek kimliği.

    lsr-bp1bpn0kn908w4nbw****
    AcceleratorId

    string

    Alibaba Cloud Global Accelerator (GA) örnek kimliği.

    ga-bp1odcab8tmno0hdq****
    EndpointConfigurations

    array<object>

    Uç nokta yapılandırma bilgileri.

    object

    Uç nokta yapılandırma bilgileri.

    Type

    string

    Uç nokta türü.

    • Domain: Özel etki alanı adı.

    • Ip: Özel IP adresi.

    • IpTarget: Özelleştirilmiş özel IP adresi.

    • PublicIp: Alibaba Cloud genel IP adresi.

    • ECS: ECS örneği.

    • SLB: SLB örneği.

    • ALB: ALB örneği.

    • OSS: OSS örneği.

    • ENI: Alibaba Cloud esnek ağ arabirimi (ENI).

    • NLB: NLB örneği.

    Ip
    EnableClientIPPreservation

    boolean

    Otomatik alma yöntemi kullanılarak istemci IP adresi koruma özelliğinin etkinleştirilip etkinleştirilmediğini belirtir.

    • true: İstemci IP adresi koruma özelliği etkinleştirilmiştir.

    • false: İstemci IP adresi koruma özelliği devre dışı bırakılmıştır.

    false
    Weight

    integer

    Uç noktanın ağırlığı.

    20
    ProbeProtocol

    string

    Gecikme izleme için yoklama protokolü.

    • icmp: ICMP.

    • tcp: TCP.

    tcp
    Endpoint

    string

    Uç noktanın IP adresi, etki alanı adı veya örnek kimliği.

    47.1.XX.XX
    EnableProxyProtocol

    boolean

    Proxy Protokolü kullanılarak istemci IP adresi koruma özelliğinin etkinleştirilip etkinleştirilmediğini belirtir.

    • true: İstemci IP adresi koruma özelliği, Proxy Protokolü kullanılarak etkinleştirilmiştir.

    • false: İstemci IP adresi koruma özelliği, Proxy Protokolü kullanılarak etkinleştirilmemiştir.

    ProbePort

    integer

    Gecikme izleme için yoklama bağlantı noktası.

    80
    EndpointId

    string

    Uç nokta kimliği.

    ep-bp1d2utp8qqe2a44t****
    SubAddress

    string

    Esnek ağ arabiriminin (ENI) özel IP adresi.

    172.168.XX.XX
    VpcId

    string

    VPC kimliği.

    vpc-8vbhucmd5b2q2fpqqu****
    VSwitchIds

    array

    VPC'deki vSwitch'lerin listesi.

    string

    vSwitch kimliği.

    vsw-hp3xwc2aebg2u30ln****
    Provider

    string

    Sağlayıcı bilgileri.

    BAILIAN
    ApiKeys

    array

    Uç nokta yapılandırmasındaki API anahtarları.

    string

    Uç nokta grubundaki ilk API anahtarı.

    sk-*******
    PortOverrides

    array<object>

    Bağlantı noktası eşlemeleri.

    object

    Bağlantı noktası eşlemeleri.

    ListenerPort

    integer

    Dinleyici bağlantı noktası.

    443
    EndpointPort

    integer

    Uç nokta bağlantı noktası.

    80
    ForwardingRuleIds

    array

    Uç nokta grubuyla ilişkilendirilmiş yönlendirme kurallarının kimlikleri.

    string

    Uç nokta grubuyla ilişkilendirilmiş yönlendirme kurallarının kimlikleri.

    frule-bp19a3t3yzr21q3****
    EndpointGroupType

    string

    Uç nokta grubu türü.

    • default: Varsayılan uç nokta grubu.

    • virtual: Sanal uç nokta grubu.

    default
    EndpointRequestProtocol

    string

    Arka uç hizmet protokolü.

    • HTTP: HTTP.

    • HTTPS: HTTPS.

    HTTP
    EndpointProtocolVersion

    string

    Arka uç hizmet protokolü sürümü.

    • HTTP1.1: HTTP1.1.

    • HTTP2: HTTP2.

    HTTP1.1
    Description

    string

    Uç nokta grubunun açıklaması.

    group1
    Name

    string

    Uç nokta grubunun adı.

    group1
    HealthCheckPort

    integer

    Sağlık kontrolü bağlantı noktası.

    10
    HealthCheckEnabled

    boolean

    Sağlık kontrollerinin etkinleştirilip etkinleştirilmediğini belirtir.

    • true: Sağlık kontrolleri etkinleştirilmiştir.

    • false: Sağlık kontrolleri devre dışı bırakılmıştır.

    true
    ServiceId

    string

    Yönetilen örneğin ait olduğu hizmet sağlayıcısının kimliği.

    Not

    Bu parametre yalnızca ServiceManaged parametresi true olarak ayarlandığında geçerlidir.

    ALB
    ServiceManaged

    boolean

    Örneğin yönetilen bir örnek olup olmadığını belirtir. Geçerli değerler:

    • true: Örnek, yönetilen bir örnektir.

    • false: Örnek, yönetilen bir örnek değildir.

    true
    ServiceManagedInfos

    array<object>

    Kullanıcıların bu yönetilen örnek üzerinde yürütebileceği eylem ilkeleri listesi.

    Not

    • Bu parametre yalnızca ServiceManaged parametresi true olarak ayarlandığında geçerlidir.

    • Bir örnek yönetilen durumdayken, örnek üzerindeki kullanıcı işlemleri kısıtlanır ve belirli işlemler yasaklanır.

    object

    Bir kullanıcının yönetilen örnek üzerinde yürütebileceği eylem ilkesi.

    Action

    string

    Yönetilen ilke eyleminin adı.

    • Create: Örnek oluşturma.

    • Update: Geçerli örneği güncelleme.

    • Delete: Geçerli örneği silme.

    • Associate: Geçerli örneği referans alma veya geçerli örnek tarafından referans alınma.

    • UserUnmanaged: Örneği yönetimden çıkarma.

    • CreateChild: Geçerli örnek altında bir alt kaynak oluşturma.

    Update
    ChildType

    string

    Alt kaynak türü.

    • Listener: Dinleyici kaynağı.

    • IpSet: Hızlandırma bölgesi kaynağı.

    • EndpointGroup: Uç nokta grubu kaynağı.

    • ForwardingRule: Yönlendirme kuralı kaynağı.

    • Endpoint: Uç nokta kaynağı.

    • EndpointGroupDestination: Özel yönlendirme dinleyicisi altındaki uç nokta grubu protokol eşleme kaynağı.

    • EndpointPolicy: Özel yönlendirme dinleyicisi altındaki uç nokta erişim ilkesi kaynağı.

    Not

    Bu parametre yalnızca Action parametresi CreateChild olarak ayarlandığında geçerlidir.

    Listener
    IsManaged

    boolean

    Yönetilen ilke eyleminin yönetilip yönetilmediğini belirtir. Geçerli değerler:

    • true: Yönetilen ilke eylemi yönetilmektedir. Kullanıcıların, yönetilen örnek üzerinde Action tarafından belirtilen işlemi gerçekleştirme izinleri yoktur.

    • false: Yönetilen ilke eylemi yönetilmemektedir. Kullanıcılar, yönetilen örnek üzerinde Action tarafından belirtilen işlemi gerçekleştirebilir.

    false
    Tags

    array<object>

    Uç nokta grubunun etiketleri.

    object

    Uç nokta grubunun etiketleri.

    Key

    string

    Uç nokta grubunun etiket anahtarı.

    test-key
    Value

    string

    Uç nokta grubunun etiket değeri.

    test-value
    HealthCheckHost

    string

    Sağlık kontrolü etki alanı adı.

    www.taobao.com
    EndpointIpVersion

    string

    Arka uç IP adresi protokolü. Geçerli değerler:

    • IPv4: (varsayılan) GA, uç nokta hizmetiyle iletişim kurmak için yalnızca IPv4 adreslerini kullanır.

    • IPv6: GA, uç nokta hizmetiyle iletişim kurmak için yalnızca IPv6 adreslerini kullanır.

    • ProtocolAffinity: GA'nın uç nokta hizmetiyle iletişim kurmak için kullandığı IP protokolü, istemci isteği tarafından kullanılan IP protokolüyle aynıdır.

    IPv4
    EndpointPrivateIpList

    array<object>

    Arka uç düğümlerinin özel IP adresları listesi.

    object

    PrivateIp

    string

    Özel IP adresı.

    172.19.115.37
    VSwitchId

    string

    VPC'deki vSwitch kimliği.

    gsw-0jl6tmriqep1ga***
    CIDR

    string

    Özel IP adresıyla ilişkili CIDR bloğu.

    10.0.0.0/24
    HealthCheckSuccessCodes

    string

    Başarılı bir sağlık kontrolünü belirten durum kodları kümesi.

    http_2xx,http_3xx
    HealthCheckMethod

    string

    Sağlık kontrolleri için kullanılan HTTP istek yöntemi.

    GET
    ProxyTunnel

    object

    Proxy tüneli yapılandırması.

    ConnectAuthPrefix

    string

    Proxy tüneli bağlantı kimlik doğrulama ön eki.

    prefix-auth
    ConnectAuthSuffix

    string

    Proxy tüneli bağlantı kimlik doğrulama son eki.

    suffix-auth
    ConnectSessionHashHdr

    string

    Oturum karması için kullanılan istek üst bilgisinin adı.

    X-Session-Hash
    ConnectTunnelTimeout

    integer

    Proxy tüneli bağlantı zaman aşımı süresi. Birim: milisaniye.

    5000
    TunnelServerPort

    integer

    Tünel sunucusu bağlantı noktası.

    8443
    TunnelServerType

    string

    Tünel sunucusu adres türü. Geçerli değerler: ip (IPv4 adresi) ve domain (etki alanı adı).

    domain
    TunnelServer

    string

    Tünel sunucusunun IPv4 adresi veya alan adı.

    tunnel.example.com

    Examples

    Success response

    JSON format

    {
  "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"
      }
    }
  ]
}

    Error codes

    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.

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.