Tüm Ürünler
Search

Bu Ürün

    :UpdateEndpointGroup

    Belge Merkezi

    :UpdateEndpointGroup

    Son Güncelleme:Oct 13, 2026

    Bir uç nokta grubunun yapılandırmalarını değiştirir.

    Operation description

    • UpdateEndpointGroup işlemi eşzamansızdır. Sistem bir istek kimliği döndürür, ancak uç nokta grubu yapılandırmaları hemen değiştirilmez. Değişiklik görevi arka planda devam eder. Uç nokta grubunun durumunu sorgulamak için DescribeEndpointGroup işlemini çağırabilirsiniz:

      • Uç nokta grubu updating durumundaysa, yapılandırmalar değiştiriliyordur. Bu durumda yalnızca sorgulama işlemleri gerçekleştirebilirsiniz.

      • Uç nokta grubu active durumundaysa, yapılandırmalar değiştirilmiştir.

    • UpdateEndpointGroup işlemi, aynı Global Accelerator (GA) örneği içindeki uç nokta grubu yapılandırmalarında eşzamanlı değişiklikleri desteklemez.

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

    update

    *EndpointGroup.

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

    		 None None

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    Yes

    Global Accelerator (GA) örneğinin bölge kimliği. Değeri cn-hangzhou olarak ayarlayın.

    cn-hangzhou
    ClientToken

    string

    No

    İsteğin yinelenmezliğini sağlamak için kullanılan istemci belirteci.

    Belirteci istemcinizde oluşturabilirsiniz. Belirtecin farklı istekler arasında benzersiz olduğundan emin olun. İstemci belirteci yalnızca ASCII karakterlerini destekler.

    Not

    Bu parametreyi belirtmezseniz, sistem otomatik olarak API isteğinin RequestId değerini ClientToken olarak kullanır. RequestId her API isteği için farklıdır.

    123e4567-e89b-12d3-a456-426655440000
    EndpointGroupId

    string

    Yes

    Uç nokta grubunun kimliği.

    epg-bp1dmlohjjz4kqaun****
    Name

    string

    No

    Uç nokta grubunun adı.

    Ad 1 ila 128 karakter uzunluğunda olmalı ve rakam, nokta (.), alt çizgi (_) ve tire (-) içerebilir. Bir harf veya Çince karakterle başlamalıdır.

    group1
    Description

    string

    No

    Uç nokta grubunun açıklaması.

    Açıklama en fazla 200 karakter uzunluğunda olabilir ve http:// veya https:// ile başlayamaz.

    EndpointGroup
    EndpointGroupRegion deprecated

    string

    No

    Uç nokta grubunun bölge kimliği.

    cn-hangzhou
    TrafficPercentage

    integer

    No

    Dinleyici birden fazla uç nokta grubuyla ilişkilendirildiğinde uç nokta grubunun ağırlığı.

    20
    HealthCheckIntervalSeconds

    integer

    No

    Ardışık iki sağlık kontrolü arasındaki aralık. Birim: saniye. Geçerli değerler: 1 ile 50.

    3
    HealthCheckPath

    string

    No

    Sağlık kontrolü yolu.

    /healthcheck
    HealthCheckPort

    integer

    No

    Sağlık kontrolü bağlantı noktası. Geçerli değerler: 1 ile 65535.

    20
    HealthCheckProtocol

    string

    No

    Sağlık kontrolü protokolü. Geçerli değerler:

    • tcp veya TCP: TCP.

    • http veya HTTP: HTTP.

    • https veya HTTPS: HTTPS.

    HTTPS
    ThresholdCount

    integer

    No

    Sağlık kontrolü durumunu değiştirmek için gereken ardışık sağlık kontrolü sayısı. Bu, durumu sağlıklıdan sağlıksıza değiştirmek için gereken ardışık başarısız sağlık kontrolü sayısını veya durumu sağlıksızdan sağlıklıya değiştirmek için gereken ardışık başarılı sağlık kontrolü sayısını ifade eder.

    Geçerli değerler: 2 ile 10.

    3
    EndpointConfigurations

    array<object>

    No

    Uç nokta yapılandırmaları.

    object

    No

    Uç nokta yapılandırmaları.

    Type

    string

    Yes

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

    • Domain: özel etki alanı adı.

    • Ip: özel IP adresi.

    • IpTarget: özel iç IP adresi.

    • PublicIp: Alibaba Cloud genel IP adresi.

    • ECS: Alibaba Cloud ECS örneği.

    • SLB: Alibaba Cloud SLB örneği.

    • ALB: Alibaba Cloud ALB örneği.

    • OSS: Alibaba Cloud OSS örneği.

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

    • NLB: Alibaba Cloud NLB örneği.

    Not

    • Uç nokta türü ECS, ENI, SLB, ALB, NLB veya IpTarget olarak ayarlanmışsa ve hizmete bağlı rol mevcut değilse, sistem otomatik olarak AliyunServiceRoleForGaVpcEndpoint adında bir hizmete bağlı rol oluşturur.

    • Uç nokta türü ALB olarak ayarlanmışsa ve hizmete bağlı rol mevcut değilse, sistem otomatik olarak AliyunServiceRoleForGaAlb adında bir hizmete bağlı rol oluşturur.

    • Uç nokta türü OSS olarak ayarlanmışsa ve hizmete bağlı rol mevcut değilse, sistem otomatik olarak AliyunServiceRoleForGaOss adında bir hizmete bağlı rol oluşturur.

    • Uç nokta türü NLB olarak ayarlanmışsa ve hizmete bağlı rol mevcut değilse, sistem otomatik olarak AliyunServiceRoleForGaNlb adında bir hizmete bağlı rol oluşturur.

    Not

    Daha fazla bilgi için bkz. Hizmete bağlı roller.

    Ip
    EnableClientIPPreservation

    boolean

    No

    Otomatik alma yöntemini kullanarak istemci IP adresı korumasının etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:

    • true: istemci IP adresı korumasını etkinleştirir.

    • false (varsayılan): istemci IP adresı korumasını devre dışı bırakır.

    Not

    • Varsayılan olarak, UDP veya TCP dinleyicileriyle ilişkilendirilmiş uç nokta grupları için istemci IP adresı koruması devre dışıdır. Bu özelliği iş gereksinimlerinize göre yapılandırabilirsiniz.

    • Varsayılan olarak, HTTP veya HTTPS dinleyicileriyle ilişkilendirilmiş uç nokta grupları için istemci IP adresı koruması etkinleştirilmiştir. İstemci IP adresları X-Forwarded-For başlık alanı aracılığıyla alınır. Bu özelliği devre dışı bırakamazsınız.

    • Hem EnableClientIPPreservation hem de EnableProxyProtocol parametrelerini true olarak ayarlayamazsınız.

    • Daha fazla bilgi için bkz. İstemci IP adreslarını koruma.

    false
    Weight

    integer

    Yes

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

    Geçerli değerler: 0 ile 255.

    Not

    Bir uç noktanın ağırlığı 0 olarak ayarlanırsa, Global Accelerator uç noktaya trafik dağıtmayı durdurur. Dikkatli olun.

    20
    EnableProxyProtocol

    boolean

    No

    Proxy Protokolü'nü kullanarak istemci IP adresı korumasının etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:

    • true: istemci IP adresı korumasını etkinleştirir.

    • false (varsayılan): istemci IP adresı korumasını devre dışı bırakır.

    Not

    • Bu parametre yalnızca TCP dinleyicileriyle ilişkilendirilmiş uç nokta grupları için desteklenir.

    • Hem EnableClientIPPreservation hem de EnableProxyProtocol parametrelerini true olarak ayarlayamazsınız.

    • Daha fazla bilgi için bkz. İstemci IP adreslarını koruma.

    false
    Endpoint

    string

    Yes

    Uç noktanın IP adresi, etki alanı adı veya örnek kimliği. Bu parametreyi uç nokta türüne göre belirtin.

    120.XX.XX.21
    SubAddress

    string

    No

    Esnek ağ arabirimi denetleyicisinin (NIC) iç IP adresi.

    Not

    Uç nokta türü ENI olarak ayarlandığında bu parametre isteğe bağlıdır. Bu parametreyi belirtmezseniz, varsayılan olarak ENI'nin birincil iç IP adresi kullanılır.

    172.168.XX.XX
    VpcId

    string

    No

    Sanal özel bulutun (VPC) kimliği.

    Akıllı yönlendirme dinleyicisiyle ilişkilendirilmiş bir uç nokta grubu için en fazla bir VPC kimliği belirtebilirsiniz.

    Not

    Bu parametre yalnızca uç nokta türü IpTarget olarak ayarlandığında gereklidir ve geçerli olur.

    vpc-2zen6t0u7xhm0k5iz****
    VSwitchIds

    array

    No

    VPC'deki vSwitch'ler.

    string

    No

    vSwitch'in kimliği.

    Akıllı yönlendirme dinleyicisiyle ilişkilendirilmiş bir uç nokta grubu için en fazla iki vSwitch kimliği belirtebilirsiniz.

    Not

    Bu parametre yalnızca uç nokta türü IpTarget olarak ayarlandığında gereklidir ve geçerli olur.

    • vSwitch, VpcId parametresiyle belirtilen VPC'ye ait olmalıdır.

    vsw-2ze2dbtkxabpvpqxc****
    Provider

    string

    No

    Uç nokta yapılandırmalarındaki hizmet sağlayıcı.

    BAILIAN
    ApiKeys

    array

    No

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

    string

    No

    Uç nokta yapılandırmalarındaki ilk API anahtarı.

    sk-******
    EndpointRequestProtocol

    string

    No

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

    • HTTP

    • HTTPS

    Not

    • Bu parametre yalnızca bir HTTP veya HTTPS dinleyici örneği için uç nokta grubu oluşturduğunuzda desteklenir.

    • Bir HTTP dinleyici örneği için, arka uç hizmeti protokolü yalnızca HTTP'yi destekler.

    HTTP
    EndpointProtocolVersion

    string

    No

    Arka uç hizmeti protokolü sürümü. Geçerli değerler:

    • HTTP1.1

    • HTTP2

    Not

    Arka uç hizmeti protokolü sürümünü yalnızca EndpointRequestProtocol parametresi HTTPS olarak ayarlandığında belirtebilirsiniz.

    HTTP1.1
    PortOverrides

    array<object>

    No

    Bağlantı noktası eşlemeleri.

    object

    No

    Bağlantı noktası eşlemeleri.

    ListenerPort

    integer

    No

    Bağlantı noktası eşlemesindeki dinleyici bağlantı noktası.

    Not

    • TCP dinleyicileri için: Sanal uç nokta grupları için bağlantı noktası eşlemeleri desteklenmez. Dinleyici altında zaten bir sanal uç nokta grubu varsa, varsayılan uç nokta grubu için bağlantı noktası eşlemeleri yapılandıramazsınız. Varsayılan uç nokta grubu için bağlantı noktası eşlemeleri zaten yapılandırılmışsa, sanal uç nokta grubu ekleyemezsiniz.

    • Bağlantı noktası eşlemelerini yapılandırdıktan sonra, sonraki dinleyici değişiklikleri için aşağıdaki sınırlamalar geçerlidir: HTTP ve HTTPS arasında geçiş yapmak dışında dinleyici protokolünü değiştiremezsiniz.

    • Dinleyici bağlantı noktası: Değiştirilen dinleyici bağlantı noktası aralığı, mevcut bağlantı noktası eşlemelerindeki tüm dinleyici bağlantı noktalarını içermelidir. Örneğin, dinleyici bağlantı noktası aralığı 80 ile 82 arasındaysa ve bağlantı noktası eşlemeleri 100 ile 102 arasındaki uç nokta bağlantı noktalarına eşlenecek şekilde yapılandırılmışsa, dinleyici bağlantı noktası aralığını 80 ile 81 olarak değiştiremezsiniz.

    443
    EndpointPort

    integer

    No

    Bağlantı noktası eşlemesindeki uç nokta bağlantı noktası.

    80
    HealthCheckEnabled

    boolean

    No

    Sağlık kontrollerinin etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:

    • true: sağlık kontrollerini etkinleştirir.

    • false (varsayılan): sağlık kontrollerini devre dışı bırakır.

    true
    HealthCheckHost

    string

    No

    Sağlık kontrolleri için kullanılan etki alanı adı.

    www.taobao.com
    EndpointIpVersion

    string

    No

    Arka uç IP adresının IP sürümü. Geçerli değerler:

    • IPv4 (varsayılan): GA, uç nokta hizmetiyle yalnızca IPv4 üzerinden iletişim kurar.

    • IPv6: GA, uç nokta hizmetiyle yalnızca IPv6 üzerinden iletişim kurar.

    • ProtocolAffinity: GA, uç nokta hizmetiyle istemci isteğiyle aynı IP sürümü üzerinden iletişim kurar.

    IPv4
    ProxyTunnel

    object

    No

    Proxy tüneli yapılandırmaları.

    ConnectAuthPrefix

    string

    No

    Proxy tüneli bağlantı kimlik doğrulaması için önek.

    prefix-auth
    ConnectAuthSuffix

    string

    No

    Proxy tüneli bağlantı kimlik doğrulaması için sonek.

    suffix-auth
    ConnectSessionHashHdr

    string

    No

    Bağlantı oturumu karması başlığı.

    X-Session-Hash
    ConnectTunnelTimeout

    integer

    No

    Proxy tüneli için bağlantı zaman aşımı süresi.

    5000
    TunnelServerPort

    integer

    No

    Tünel sunucusu bağlantı noktası.

    8443
    TunnelServerType

    string

    No

    Tünel sunucusu türü.

    domain
    TunnelServer

    string

    No

    Proxy tünelinin sunucu adresi.

    tunnel.example.com
    HealthCheckMethod

    string

    No

    Sağlık kontrolü yöntemi.

    GET
    HealthCheckSuccessCodes

    string

    No

    Sağlık kontrolleri için başarı durum kodları.

    http_2xx,http_3xx

    Response elements

    Element

    Type

    Description

    Example

    object

    Döndürülen bilgiler.

    RequestId

    string

    İstek kimliği.

    6FEA0CF3-D3B9-43E5-A304-D217037876A8

    Examples

    Success response

    JSON format

    {
  "RequestId": "6FEA0CF3-D3B9-43E5-A304-D217037876A8\t"
}

    Error codes

    HTTP status code

    Error code

    Error message

    Description
    400 NoPermission.EnableHealthCheck You do not have permission to enable health check.
    400 NotExist.EndPointGroup The endpoint group does not exist.
    400 StateError.EndPointGroup The specified state of endpoint group is invalid.
    400 NotExist.Listener The listener does not exist.
    400 NotActive.Listener The state of the listener is not active.
    400 NotExist.Accelerator The accelerated instance does not exist.
    400 StateError.Accelerator The state of the accelerated instance is invalid.
    400 QuotaExceeded.EndPoint The maximum number of endpoints is exceeded.
    400 NoPermission.VpcEndpoint You are not authorized to perform the operation.
    400 EndPointRequestProtocolIllegal.EndpointGroup endpoint group request protoco is illegal
    400 QuotaExceeded.PortOverride The number of port override exceeds the limit.
    400 NotExist.ListenerPort listener port %s is not exist

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.