All Products
Search

This Product

    Global Accelerator:UpdateEndpointGroup

    Document Center

    Global Accelerator:UpdateEndpointGroup

    Last Updated:Apr 02, 2026

    Memperbarui konfigurasi kelompok titik akhir.

    Deskripsi operasi

    • API UpdateEndpointGroup merupakan API asinkron. Setelah dipanggil, sistem mengembalikan ID permintaan dan memulai pembaruan di latar belakang; konfigurasi tidak langsung dimodifikasi. Untuk memeriksa status kelompok titik akhir, panggil DescribeEndpointGroup:

      • Jika kelompok titik akhir berada dalam status updating, konfigurasinya sedang dimodifikasi dan Anda hanya dapat melakukan kueri.

      • Jika kelompok titik akhir berada dalam status active, pembaruan telah selesai.

    • API UpdateEndpointGroup tidak mendukung pembaruan konkuren terhadap kelompok titik akhir dalam instans Global Accelerator yang sama.

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

    update

    *EndpointGroup

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

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    Yes

    ID wilayah tempat instans Global Accelerator ditempatkan. Tetapkan nilainya ke cn-hangzhou.

    cn-hangzhou
    ClientToken

    string

    No

    Token yang dihasilkan client untuk memastikan idempotensi permintaan.

    Token harus unik di seluruh permintaan dan hanya boleh berisi karakter ASCII.

    Catatan

    Jika Anda tidak menentukan parameter ini, sistem secara otomatis menggunakan RequestId dari permintaan API sebagai ClientToken. RequestId bersifat unik untuk setiap permintaan API.

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

    string

    Yes

    ID kelompok titik akhir.

    epg-bp1dmlohjjz4kqaun****
    Name

    string

    No

    Nama kelompok titik akhir.

    Nama harus terdiri dari 1 hingga 128 karakter, dimulai dengan huruf atau karakter Tionghoa, serta dapat berisi angka, titik (.), garis bawah (_), dan tanda hubung (-).

    group1
    Description

    string

    No

    Deskripsi kelompok titik akhir.

    Deskripsi dapat mencapai panjang maksimum 200 karakter dan tidak boleh dimulai dengan http:// atau https://.

    EndpointGroup
    EndpointGroupRegion

    string

    Yes

    ID wilayah tempat kelompok titik akhir ditempatkan.

    cn-hangzhou
    TrafficPercentage

    integer

    No

    Bobot kelompok titik akhir ketika listener dikaitkan dengan beberapa kelompok titik akhir.

    20
    HealthCheckIntervalSeconds

    integer

    No

    Interval antar pemeriksaan kesehatan, dalam satuan detik. Nilai valid: 1 hingga 50.

    3
    HealthCheckPath

    string

    No

    Jalur untuk pemeriksaan kesehatan.

    /healthcheck
    HealthCheckPort

    integer

    No

    Port yang digunakan untuk pemeriksaan kesehatan. Nilai valid: 1 hingga 65535.

    20
    HealthCheckProtocol

    string

    No

    Protokol untuk pemeriksaan kesehatan. Nilai valid:

    • tcp atau TCP

    • http atau HTTP

    • https atau HTTPS

    HTTPS
    ThresholdCount

    integer

    No

    Jumlah pemeriksaan kesehatan berturut-turut yang berhasil atau gagal yang diperlukan untuk mengubah status kesehatan titik akhir.

    Nilai valid: 2 hingga 10.

    3
    EndpointConfigurations

    array<object>

    No

    Konfigurasi titik akhir.

    object

    No

    Konfigurasi titik akhir.

    Type

    string

    Yes

    Jenis titik akhir. Nilai valid:

    • 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: Instance ALB.

    • OSS: Instance OSS.

    • ENI: antarmuka jaringan elastis.

    • NLB: Instance NLB.

    Catatan

    • Jika jenis titik akhir adalah ECS, ENI, SLB, atau IpTarget, dan peran terkait layanan belum ada, sistem secara otomatis membuat peran terkait layanan bernama AliyunServiceRoleForGaVpcEndpoint.

    • Jika jenis titik akhir adalah ALB, dan peran terkait layanan belum ada, sistem secara otomatis membuat peran terkait layanan bernama AliyunServiceRoleForGaAlb.

    • Jika jenis titik akhir adalah OSS, dan peran terkait layanan belum ada, sistem secara otomatis membuat peran terkait layanan bernama AliyunServiceRoleForGaOss.

    • Jika jenis titik akhir adalah NLB, dan peran terkait layanan belum ada, sistem secara otomatis membuat peran terkait layanan bernama AliyunServiceRoleForGaNlb.

    Catatan

    Untuk informasi lebih lanjut, lihat peran terkait layanan.

    Ip
    EnableClientIPPreservation

    boolean

    No

    Menentukan apakah akan mempertahankan alamat IP sumber client. Nilai valid:

    • true: Mempertahankan alamat IP sumber client.

    • false (default): Tidak mempertahankan alamat IP sumber client.

    Catatan

    • Untuk kelompok titik akhir listener TCP atau UDP, fitur ini dinonaktifkan secara default tetapi dapat diaktifkan jika diperlukan.

    • Untuk kelompok titik akhir listener HTTP atau HTTPS, alamat IP sumber client dipertahankan secara default. Alamat IP client diambil dari Header X-Forwarded-For. Anda tidak dapat menonaktifkan fitur ini.

    • Anda tidak dapat mengatur EnableClientIPPreservation dan EnableProxyProtocol menjadi true secara bersamaan.

    • Untuk informasi lebih lanjut, lihat mempertahankan alamat IP sumber client.

    false
    Weight

    integer

    Yes

    Bobot titik akhir.

    Nilai valid: 0 hingga 255.

    Catatan

    Jika Anda mengatur bobot titik akhir menjadi 0, Global Accelerator berhenti mendistribusikan traffic ke titik akhir tersebut. Lakukan dengan hati-hati.

    20
    EnableProxyProtocol

    boolean

    No

    Menentukan apakah akan menggunakan Proxy Protocol untuk mempertahankan alamat IP sumber client. Nilai valid:

    • true: Mempertahankan alamat IP sumber client.

    • false (default): Tidak mempertahankan alamat IP sumber client.

    Catatan

    • Anda hanya dapat mengonfigurasi parameter ini untuk kelompok titik akhir listener TCP.

    • Anda tidak dapat mengatur EnableClientIPPreservation dan EnableProxyProtocol menjadi true secara bersamaan.

    • Untuk informasi lebih lanjut, lihat mempertahankan alamat IP sumber client.

    false
    Endpoint

    string

    Yes

    Masukkan alamat IP, nama domain, atau ID instans berdasarkan nilai parameter Type.

    120.XX.XX.21
    SubAddress

    string

    No

    Alamat IP pribadi antarmuka jaringan elastis.

    Catatan

    Jika jenis titik akhir adalah ENI, Anda dapat menentukan parameter ini. Jika Anda mengabaikan parameter ini, alamat IP pribadi utama ENI akan digunakan.

    172.168.XX.XX
    VpcId

    string

    No

    ID VPC.

    Anda dapat menentukan paling banyak satu ID VPC untuk kelompok titik akhir yang dikaitkan dengan listener routing cerdas.

    Catatan

    Parameter ini wajib hanya jika jenis titik akhir adalah IpTarget.

    vpc-2zen6t0u7xhm0k5iz****
    VSwitchIds

    array

    No

    Daftar vSwitch di dalam VPC.

    string

    No

    ID vSwitch.

    Anda dapat menentukan paling banyak dua ID vSwitch untuk kelompok titik akhir yang dikaitkan dengan listener routing cerdas.

    Catatan

    Parameter ini wajib hanya jika jenis titik akhir adalah IpTarget.

    • vSwitch harus termasuk dalam VPC yang ditentukan oleh parameter VpcId.

    vsw-2ze2dbtkxabpvpqxc****
    Provider

    string

    No

    BAILIAN
    ApiKeys

    array

    No

    string

    No

    sk-******
    EndpointRequestProtocol

    string

    No

    Protokol layanan backend. Nilai valid:

    • HTTP

    • HTTPS

    Catatan

    • Anda hanya dapat mengonfigurasi parameter ini untuk kelompok titik akhir listener HTTP atau HTTPS.

    • Untuk listener HTTP, protokol layanan backend harus HTTP.

    HTTP
    EndpointProtocolVersion

    string

    No

    Versi protokol layanan backend. Nilai valid:

    • HTTP1.1

    • HTTP2

    Catatan

    Anda hanya dapat mengonfigurasi parameter ini ketika EndpointRequestProtocol diatur ke HTTPS.

    HTTP1.1
    PortOverrides

    array<object>

    No

    Pengaturan penggantian port.

    object

    No

    Pengaturan penggantian port.

    ListenerPort

    integer

    No

    Port listener dalam pengaturan penggantian port.

    Catatan

    • Untuk listener TCP, kelompok titik akhir virtual tidak mendukung penggantian port. Jika listener sudah dikaitkan dengan kelompok titik akhir virtual, Anda tidak dapat mengonfigurasi penggantian port untuk kelompok titik akhir default. Jika kelompok titik akhir default telah dikonfigurasi dengan penggantian port, Anda tidak dapat menambahkan kelompok titik akhir virtual.

    • Setelah Anda mengonfigurasi penggantian port, Anda hanya dapat mengubah protokol listener antara HTTP dan HTTPS.

    • Range port listener yang diperbarui harus mencakup semua port listener dalam penggantian port yang dikonfigurasi. Misalnya, jika range port listener adalah 80–82 dan penggantian port dikonfigurasi untuk memetakan port tersebut ke port titik akhir 100–102, Anda tidak dapat memperbarui range port listener menjadi 80–81.

    443
    EndpointPort

    integer

    No

    Port titik akhir dalam pengaturan penggantian port.

    80
    HealthCheckEnabled

    boolean

    No

    Menentukan apakah akan mengaktifkan pemeriksaan kesehatan. Nilai valid:

    • true: Mengaktifkan pemeriksaan kesehatan.

    • false (default): Menonaktifkan pemeriksaan kesehatan.

    true
    HealthCheckHost

    string

    No

    Nama domain untuk pemeriksaan kesehatan.

    www.taobao.com
    EndpointIpVersion

    string

    No

    Menentukan protokol IP yang digunakan Global Accelerator untuk berkomunikasi dengan titik akhir. Nilai valid: ● IPv4 (default): Gunakan IPv4. ● IPv6: Gunakan IPv6. ● ProtocolAffinity: Gunakan protokol IP yang sama dengan permintaan client.

    IPv4

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Data yang dikembalikan dalam respons.

    RequestId

    string

    ID permintaan.

    6FEA0CF3-D3B9-43E5-A304-D217037876A8

    Contoh

    Respons sukses

    JSONformat

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

    Kode kesalahan

    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

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.