全部产品
Search

搜索本产品

    Global Accelerator：CreateEndpointGroups

    文档中心

    Global Accelerator：CreateEndpointGroups

    更新时间：Dec 31, 2025

    Membuat kelompok titik akhir.

    Deskripsi operasi

    • Operasi ini membuat kelompok titik akhir secara batch. Anda tidak dapat membuat kelompok titik akhir default dan kelompok titik akhir virtual dalam permintaan yang sama.

    • Operasi ini tidak mendukung pembuatan kelompok titik akhir virtual untuk listener Lapisan 4. Untuk membuat kelompok titik akhir virtual untuk listener Lapisan 4, panggil operasi CreateEndpointGroup.

    • CreateEndpointGroups adalah operasi asinkron. Setelah permintaan dikirim, sistem mengembalikan ID permintaan, tetapi kelompok titik akhir belum dibuat secara langsung. Sistem membuat kelompok titik akhir di latar belakang. Anda dapat memanggil operasi DescribeEndpointGroup atau ListEndpointGroups untuk mengecek status kelompok titik akhir:

      • Jika kelompok titik akhir berada dalam status init, berarti kelompok tersebut sedang dalam proses pembuatan. Dalam status ini, Anda hanya dapat melakukan operasi penelusuran.

      • Jika semua kelompok titik akhir berada dalam status active, berarti kelompok tersebut telah berhasil dibuat.

    • Anda tidak dapat memanggil operasi CreateEndpointGroups secara bersamaan untuk membuat kelompok titik akhir pada 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:CreateEndpointGroups

    create

    *EndpointGroup

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

    *Accelerator

    acs:ga:{#regionId}:{#accountId}:ga/{#acceleratorId}

    *Listener

    acs:ga:{#regionId}:{#accountId}:listener/{#listenerId}
    • ga:AcceleratorMainland
    		 None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    Yes

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

    cn-hangzhou
    ClientToken

    string

    No

    Token klien yang digunakan untuk memastikan idempotensi permintaan.

    Buat nilai untuk parameter ini di sisi klien Anda. Pastikan nilainya unik di antara permintaan yang berbeda. Token hanya boleh berisi karakter ASCII.

    Catatan

    Jika Anda tidak menentukan parameter ini, sistem secara otomatis menggunakan RequestId dari permintaan sebagai ClientToken. RequestId mungkin berbeda untuk setiap permintaan.

    1F4B6A4A-C89E-489E-BAF1-52777EE148EF
    DryRun

    boolean

    No

    Menentukan apakah akan menjalankan dry run. Nilai yang valid:

    • true: menjalankan dry run. Sistem memeriksa parameter yang diperlukan, format permintaan, dan batas layanan. Jika permintaan gagal dalam dry run, pesan error dikembalikan. Jika permintaan lolos dry run, sistem mengembalikan kode status HTTP 2xx.

    • false (default): menjalankan dry run dan mengirim permintaan. Jika permintaan lolos dry run, kode status HTTP 2xx dikembalikan dan operasi dijalankan.

    true
    AcceleratorId

    string

    Yes

    ID instans GA.

    ga-bp1odcab8tmno0hdq****
    ListenerId

    string

    Yes

    ID listener.

    Catatan

    Ketika protokol listener adalah HTTP atau HTTPS, Anda hanya dapat membuat satu kelompok titik akhir untuk setiap pemanggilan.

    lsr-bp1bpn0kn908w4nbw****
    EndpointGroupConfigurations

    array<object>

    Yes

    Konfigurasi kelompok titik akhir.

    Anda dapat menentukan informasi hingga 10 kelompok titik akhir.

    array<object>

    No

    Konfigurasi kelompok titik akhir.

    Anda dapat menentukan informasi hingga 10 kelompok titik akhir.

    EndpointGroupName

    string

    No

    Nama kelompok titik akhir.

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

    group1
    EndpointGroupDescription

    string

    No

    Deskripsi kelompok titik akhir.

    Panjang deskripsi maksimal 200 karakter dan tidak boleh dimulai dengan `http://` atau `https://`.

    EndpointGroup
    EndpointGroupRegion

    string

    Yes

    ID wilayah tempat Anda ingin membuat kelompok titik akhir.

    Anda dapat menentukan hingga 10 ID wilayah.

    cn-hongkong
    TrafficPercentage

    integer

    No

    Rasio distribusi traffic. Jika sebuah listener dikaitkan dengan beberapa kelompok titik akhir, sistem mendistribusikan traffic ke masing-masing kelompok berdasarkan rasionya.

    Nilai yang valid: 1 hingga 100. Nilai default: 100.

    Anda dapat menentukan rasio distribusi traffic untuk hingga 10 kelompok titik akhir.

    100
    HealthCheckEnabled

    boolean

    No

    Menentukan apakah fitur pemeriksaan kesehatan diaktifkan untuk kelompok titik akhir. Nilai yang valid:

    • true: mengaktifkan fitur pemeriksaan kesehatan.

    • false (default): menonaktifkan fitur pemeriksaan kesehatan.

    Anda dapat mengaktifkan fitur pemeriksaan kesehatan untuk hingga 10 kelompok titik akhir.

    false
    HealthCheckIntervalSeconds

    integer

    No

    Interval antara dua pemeriksaan kesehatan berturut-turut. Satuan: detik.

    Anda dapat menentukan hingga 10 interval pemeriksaan kesehatan.

    5
    HealthCheckPath

    string

    No

    Jalur tempat permintaan pemeriksaan kesehatan dikirim.

    Anda dapat menentukan hingga 10 jalur pemeriksaan kesehatan.

    /healthcheck
    HealthCheckPort

    integer

    No

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

    Anda dapat menentukan hingga 10 port untuk pemeriksaan kesehatan.

    443
    HealthCheckProtocol

    string

    No

    Protokol yang digunakan untuk pemeriksaan kesehatan. Nilai yang valid:

    • tcp atau TCP

    • http atau HTTP

    • https atau HTTPS

    Anda dapat menentukan hingga 10 protokol pemeriksaan kesehatan.

    HTTPS
    ThresholdCount

    integer

    No

    Jumlah kegagalan pemeriksaan kesehatan berturut-turut yang harus terjadi sebelum titik akhir yang sehat dianggap tidak sehat, atau jumlah keberhasilan pemeriksaan kesehatan berturut-turut yang harus terjadi sebelum titik akhir yang tidak sehat dianggap sehat. Nilai yang valid: 2 hingga 10. Nilai default: 3.

    Anda dapat menentukan jumlah pemeriksaan kesehatan berturut-turut untuk hingga 10 kelompok titik akhir.

    3
    EndpointConfigurations

    array<object>

    No

    Konfigurasi titik akhir dalam kelompok titik akhir yang dikaitkan dengan listener yang menggunakan perutean pintar.

    object

    No

    Konfigurasi titik akhir dalam kelompok titik akhir yang dikaitkan dengan listener yang menggunakan perutean pintar.

    Type

    string

    No

    Jenis titik akhir dalam kelompok titik akhir. Nilai yang valid:

    • Domain: nama domain kustom.

    • Ip: alamat IP kustom.

    • IpTarget: alamat IP pribadi.

    • PublicIp: alamat IP publik Alibaba Cloud.

    • ECS: instans Elastic Compute Service (ECS) Alibaba Cloud.

    • SLB: instans Server Load Balancer (SLB) Alibaba Cloud.

    • ALB: instans Application Load Balancer (ALB) Alibaba Cloud.

    • OSS: bucket Object Storage Service (OSS) Alibaba Cloud.

    • ENI: Elastic Network Interface (ENI) Alibaba Cloud.

    • NLB: instans Network Load Balancer (NLB) Alibaba Cloud.

    Anda dapat menentukan hingga 100 jenis titik akhir untuk satu kelompok titik akhir.

    Catatan

    • Parameter ini wajib jika tipe perutean listener adalah Standard. Anda dapat mengonfigurasi kelompok titik akhir dan titik akhir untuk listener yang menggunakan perutean pintar.

    • Jika Anda menetapkan tipe titik akhir ke ECS, ENI, SLB, ALB, NLB, atau IpTarget, dan peran terkait layanan belum ada, sistem secara otomatis membuat peran terkait layanan bernama AliyunServiceRoleForGaVpcEndpoint.

    • Jika Anda menetapkan tipe titik akhir ke ALB dan peran terkait layanan belum ada, sistem secara otomatis membuat peran terkait layanan bernama AliyunServiceRoleForGaAlb.

    • Jika Anda menetapkan tipe titik akhir ke OSS dan peran terkait layanan belum ada, sistem secara otomatis membuat peran terkait layanan bernama AliyunServiceRoleForGaOss.

    • Jika Anda menetapkan tipe titik akhir ke NLB dan peran terkait layanan belum ada, sistem secara otomatis membuat peran terkait layanan bernama AliyunServiceRoleForGaNlb.

    Catatan

    Untuk informasi selengkapnya, lihat Service-linked Role.

    Domain
    Weight

    integer

    No

    Bobot titik akhir.

    Nilai yang valid: 0 hingga 255.

    Catatan

    Jika Anda menetapkan bobot titik akhir ke 0, Global Accelerator berhenti mendistribusikan traffic ke titik akhir tersebut. Harap berhati-hati saat menggunakan pengaturan ini.

    255
    Endpoint

    string

    No

    Alamat IP atau nama domain titik akhir yang dikaitkan dengan listener yang menggunakan perutean pintar.

    Anda dapat menentukan hingga 100 alamat IP atau nama domain titik akhir untuk satu kelompok titik akhir.

    1.1.1.1
    SubAddress

    string

    No

    Alamat IP pribadi ENI.

    Catatan

    Parameter ini hanya tersedia ketika tipe titik akhir diatur ke ENI. Jika Anda tidak menentukan parameter ini, alamat IP pribadi utama ENI akan digunakan.

    172.168.XX.XX
    EnableClientIPPreservation

    boolean

    No

    Menentukan apakah alamat IP klien dipertahankan. Nilai yang valid:

    • true: mempertahankan alamat IP klien.

    • false (default): tidak mempertahankan alamat IP klien.

    Catatan

    • Secara default, alamat IP klien tidak dipertahankan untuk kelompok titik akhir listener UDP dan TCP. Anda dapat mengonfigurasi fitur ini sesuai kebutuhan.

    • Untuk kelompok titik akhir listener HTTP dan HTTPS, alamat IP klien dipertahankan secara default. Anda dapat memperoleh alamat IP klien dari Header X-Forwarded-For. Fitur ini tidak dapat dinonaktifkan.

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

    • Untuk informasi selengkapnya, lihat Preserve client IP addresses.

    false
    EnableProxyProtocol

    boolean

    No

    Menentukan apakah protokol proxy digunakan untuk mempertahankan alamat IP klien. Nilai yang valid:

    • true: menggunakan protokol proxy.

    • false (default): tidak menggunakan protokol proxy.

    Catatan

    • Parameter ini hanya tersedia untuk kelompok titik akhir listener TCP.

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

    • Untuk informasi selengkapnya, lihat Preserve client IP addresses.

    false
    VpcId

    string

    No

    ID VPC.

    Anda dapat menentukan satu ID VPC untuk satu kelompok titik akhir.

    Catatan

    Parameter ini wajib dan hanya berlaku ketika tipe titik akhir diatur ke IpTarget.

    vpc-2zekzii824szm3hps****
    VSwitchIds

    array

    No

    Daftar vSwitch dalam VPC.

    string

    No

    ID vSwitch.

    Anda dapat menentukan hingga dua ID vSwitch untuk satu kelompok titik akhir.

    Catatan

    Parameter ini wajib dan hanya berlaku ketika tipe titik akhir diatur ke IpTarget.

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

    vsw-bp1b2qx7y2qqnbkan****
    EndpointRequestProtocol

    string

    No

    Protokol layanan backend. Nilai yang valid:

    • HTTP

    • HTTPS

    Catatan

    • Anda hanya dapat mengatur parameter ini saat membuat kelompok titik akhir untuk listener HTTP atau HTTPS.

    • Untuk listener HTTP, protokol layanan backend harus HTTP.

    HTTPS
    EndpointProtocolVersion

    string

    No

    Versi protokol layanan backend. Nilai yang valid:

    • HTTP1.1 (default)

    • HTTP2

    Catatan

    Parameter ini hanya tersedia ketika parameter EndpointRequestProtocol diatur ke HTTPS.

    HTTP1.1
    EndpointGroupType

    string

    No

    Jenis kelompok titik akhir. Nilai yang valid:

    • default (default)

    • virtual

    Anda dapat menentukan hingga 10 jenis kelompok titik akhir.

    default
    PortOverrides

    array<object>

    No

    Pemetaan port.

    object

    No

    Pemetaan port.

    ListenerPort

    integer

    No

    Port listener.

    Nilai yang valid: 1 hingga 65499.

    Catatan

    • Untuk listener TCP, pemetaan port tidak didukung untuk kelompok titik akhir virtual. Jika listener dikaitkan dengan kelompok titik akhir virtual, Anda tidak dapat mengonfigurasi pemetaan port untuk kelompok titik akhir default. Jika Anda telah mengonfigurasi pemetaan port untuk kelompok titik akhir default, Anda tidak dapat menambahkan kelompok titik akhir virtual.

    • Setelah Anda mengonfigurasi pemetaan port, Anda tidak dapat mengubah protokol listener, kecuali untuk beralih antara HTTP dan HTTPS.

    • Rentang port listener yang Anda ubah harus mencakup semua port listener yang digunakan untuk pemetaan port. Misalnya, jika rentang port listener adalah 80–82 dan Anda memetakan port listener tersebut ke port titik akhir 100–102, Anda tidak dapat mengubah rentang port listener menjadi 80–81.

    80
    EndpointPort

    integer

    No

    Port titik akhir.

    443
    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 dimulai dengan `aliyun` atau `acs:`. Tidak boleh mengandung `http://` atau `https://`.

    Anda dapat menentukan hingga 20 kunci tag.

    tag-key
    Value

    string

    No

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

    Panjang nilai tag maksimal 128 karakter dan tidak boleh dimulai dengan `aliyun` atau `acs:`. Tidak boleh mengandung `http://` atau `https://`.

    Anda dapat menentukan hingga 20 nilai tag.

    tag-value

    SystemTag

    array<object>

    No

    Parameter ini tidak digunakan.

    object

    No

    Parameter ini tidak digunakan.

    Key

    string

    No

    Parameter ini tidak digunakan.

    -
    Value

    string

    No

    Parameter ini tidak digunakan.

    -
    Scope

    string

    No

    Parameter ini tidak digunakan.

    -
    HealthCheckHost

    string

    No

    Nama domain yang digunakan untuk pemeriksaan kesehatan.

    www.taobao.com

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Data yang dikembalikan.

    RequestId

    string

    ID permintaan.

    6FEA0CF3-D3B9-43E5-A304-D217037876A8
    EndpointGroupIds

    array

    ID kelompok titik akhir.

    string

    ID kelompok titik akhir.

    epg-bp1dmlohjjz4kqaun****

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "6FEA0CF3-D3B9-43E5-A304-D217037876A8",
  "EndpointGroupIds": [
    "epg-bp1dmlohjjz4kqaun****"
  ]
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 Domain.NotFit The domain is not fit the rule
    400 Resource.QuotaFull The resource quota is exceeded.
    400 NoPermission.EnableHealthCheck You do not have permission to enable health check.
    400 NotSupportHealthCheck.Accelerator Currently Accelerator does not support health check.
    400 EndpointGroupExclusive.Listener All endpoint group must under the same listener.
    400 RegionConflict.EndpointGroup Endpoint group under the same listener must have different region.
    400 ListenerProtocolIllegal.EndpointGroup Listener protocol is illegal, the https/http listener instance is only allowed to have one default endpoint group.
    400 QuotaExceeded.EndpointGroup The number of endpoint group exceeds the limit.
    400 ParamExclusive.EndpointGroupType All endpoint group type group must be consistent.
    400 HealthCheckPath.Illegal Health check path illegal.
    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 NotExist.BusinessRegion The business region does not exist.
    400 NotExist.BasicBandwidthPackage You must specify the basic bandwidth package.
    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
    400 MixedVpc.EndPoint VPC Endpoint cannot be mixed with other types of Endpoints.
    400 IllegalPublicIp.EndPoint The public IP address configured for the endpoint is invalid. Only an Alibaba Cloud public IP address in the region of the endpoint can be configured.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.