CreateEndpointGroup - Global Accelerator

Membuat kelompok titik akhir.

Deskripsi operasi

Sebelum membuat kelompok titik akhir virtual untuk listener Lapisan 4, pastikan kelompok titik akhir default telah dibuat.
CreateEndpointGroup adalah operasi asinkron. Setelah permintaan dikirim, sistem mengembalikan ID kelompok titik akhir, tetapi pembuatan kelompok tersebut masih berlangsung di latar belakang. Anda dapat memanggil operasi DescribeEndpointGroup untuk memeriksa status kelompok titik akhir:
- Jika status kelompok titik akhir adalah init, berarti proses pembuatan sedang berjalan. Dalam status ini, hanya operasi kueri yang dapat dilakukan.
- Jika status kelompok titik akhir adalah active, berarti pembuatan telah berhasil.
Anda tidak dapat memanggil operasi CreateEndpointGroup secara bersamaan untuk membuat beberapa kelompok titik akhir dalam instansiasi 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:CreateEndpointGroup

create

*EndpointGroup

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

*Listener

acs:ga:{#regionId}:{#accountId}:listener/{#listenerId}

*Accelerator

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

ga:AcceleratorMainland

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	ID wilayah dari instansiasi Global Accelerator. Tetapkan nilainya ke cn-hangzhou.	cn-hangzhou
ClientToken	string	No	Token klien yang digunakan untuk memastikan idempotensi permintaan. Hasilkan token menggunakan klien Anda untuk memastikan token tersebut 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.	123e4567-e89b-12d3-a456-426655440000
AcceleratorId	string	Yes	ID instansiasi Global Accelerator.	ga-bp1odcab8tmno0hdq****
Name	string	No	Nama kelompok titik akhir. Nama harus terdiri dari 1 hingga 128 karakter, dimulai dengan huruf, dan dapat berisi angka, titik (.), garis bawah (_), serta tanda hubung (-).	group1
Description	string	No	Deskripsi kelompok titik akhir. Deskripsi dapat memiliki panjang maksimal 200 karakter dan tidak boleh dimulai dengan `http://` atau `https://`.	EndpointGroup
EndpointGroupRegion	string	Yes	ID wilayah tempat kelompok titik akhir ditempatkan.	cn-hangzhou
ListenerId	string	Yes	ID listener.	lsr-bp1bpn0kn908w4nbw****
TrafficPercentage	integer	No	Persentase trafik yang didistribusikan ke kelompok titik akhir. Jika sebuah listener dikaitkan dengan beberapa kelompok titik akhir, parameter ini menentukan persentase trafik yang didistribusikan ke kelompok titik akhir tersebut. Nilai yang valid: 1 hingga 100.	20
HealthCheckIntervalSeconds	integer	No	Interval pelaksanaan pemeriksaan kesehatan. Satuan: detik.	3
HealthCheckPath	string	No	Jalur tempat permintaan pemeriksaan kesehatan dikirim.	/healthcheck
HealthCheckPort	integer	No	Port yang digunakan untuk pemeriksaan kesehatan.	20
HealthCheckProtocol	string	No	Protokol yang digunakan untuk pemeriksaan kesehatan. Nilai yang valid: tcp atau TCP http atau HTTP https atau HTTPS	tcp
ThresholdCount	integer	No	Jumlah keberhasilan pemeriksaan kesehatan berturut-turut yang harus terjadi sebelum titik akhir yang tidak sehat dianggap sehat, atau jumlah kegagalan pemeriksaan kesehatan berturut-turut yang harus terjadi sebelum titik akhir yang sehat dianggap tidak sehat. Nilai yang valid: 2 hingga 10. Nilai default: 3.	3
EndpointConfigurations	array<object>	No	Konfigurasi titik akhir.
	object	No	Konfigurasi titik akhir.
Type	string	Yes	Jenis titik akhir. Nilai yang valid: Domain: nama domain kustom. Ip: alamat IP kustom. IpTarget: alamat IP pribadi kustom. 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. Catatan Jika Anda menetapkan jenis titik akhir ke ECS, ENI, SLB, ALB, NLB, atau IpTarget, sistem secara otomatis membuat peran terkait layanan bernama AliyunServiceRoleForGaVpcEndpoint jika peran tersebut belum ada. Jika Anda menetapkan jenis titik akhir ke ALB, sistem secara otomatis membuat peran terkait layanan bernama AliyunServiceRoleForGaAlb jika peran tersebut belum ada. Jika Anda menetapkan jenis titik akhir ke OSS, sistem secara otomatis membuat peran terkait layanan bernama AliyunServiceRoleForGaOss jika peran tersebut belum ada. Jika Anda menetapkan jenis titik akhir ke NLB, sistem secara otomatis membuat peran terkait layanan bernama AliyunServiceRoleForGaNlb jika peran tersebut belum ada. Catatan Untuk informasi selengkapnya, lihat Peran terkait layanan.	Ip
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 Parameter ini tidak tersedia secara default untuk kelompok titik akhir listener UDP atau TCP. Anda dapat mengonfigurasi parameter ini sesuai kebutuhan. Fitur ini diaktifkan secara default untuk kelompok titik akhir listener HTTP atau HTTPS. Alamat IP klien dipertahankan dalam bidang header X-Forwarded-For. Anda tidak dapat menonaktifkan fitur ini. Anda tidak dapat mengatur EnableClientIPPreservation dan EnableProxyProtocol ke true secara bersamaan. Untuk informasi selengkapnya, lihat Pertahankan alamat IP klien.	false
Weight	integer	Yes	Bobot titik akhir. Nilai yang valid: 0 hingga 255. Catatan Jika Anda menetapkan bobot titik akhir ke 0, Global Accelerator akan berhenti mendistribusikan trafik ke titik akhir tersebut. Harap berhati-hati.	20
EnableProxyProtocol	boolean	No	Menentukan apakah Proxy Protocol digunakan untuk mempertahankan alamat IP klien. Nilai yang valid: true: mempertahankan alamat IP klien. false (default): tidak mempertahankan alamat IP klien. Catatan Anda hanya dapat mengonfigurasi parameter ini untuk kelompok titik akhir listener TCP. Anda tidak dapat mengatur EnableClientIPPreservation dan EnableProxyProtocol ke true secara bersamaan. Untuk informasi selengkapnya, lihat Pertahankan alamat IP klien.	false
Endpoint	string	Yes	Alamat IP, nama domain, atau ID instans titik akhir. Nilai parameter ini bergantung pada nilai parameter Type.	120.1.XX.XX
SubAddress	string	No	Alamat IP pribadi ENI. Catatan Parameter ini hanya tersedia ketika jenis titik akhir adalah ENI. Jika Anda tidak menentukan parameter ini, alamat IP pribadi utama ENI akan digunakan secara default.	172.168.X.X
VpcId	string	No	ID VPC. Anda hanya dapat menentukan satu ID VPC untuk kelompok titik akhir yang dikaitkan dengan listener perutean pintar. Catatan Parameter ini wajib dan hanya berlaku ketika jenis titik akhir adalah IpTarget.	vpc-bp1quce3451z5b2hv****
VSwitchIds	array	No	Daftar vSwitch di dalam VPC.
	string	No	ID vSwitch. Anda dapat menentukan hingga dua ID vSwitch untuk kelompok titik akhir yang dikaitkan dengan listener perutean pintar. Catatan Parameter ini wajib dan hanya berlaku ketika jenis titik akhir adalah IpTarget. vSwitch harus termasuk dalam VPC yang ditentukan oleh parameter VpcId.	vsw-bp12mho4ze51ezagm****
EndpointRequestProtocol	string	No	Protokol layanan backend. Nilai yang valid: HTTP (default) 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.	HTTP
EndpointProtocolVersion	string	No	Versi protokol layanan backend. Nilai yang valid: HTTP1.1 (default): HTTP/1.1 HTTP2: HTTP/2 Catatan Parameter ini hanya tersedia ketika protokol layanan backend diatur ke HTTPS.	HTTP1.1
EndpointGroupType	string	No	Jenis kelompok titik akhir. Nilai yang valid: default (default): kelompok titik akhir default. virtual: kelompok titik akhir virtual. Catatan Sebelum membuat kelompok titik akhir virtual untuk listener Lapisan 4, pastikan kelompok titik akhir default telah dibuat.	default
PortOverrides	array<object>	No	Pemetaan port.
	object	No	Pemetaan port.
ListenerPort	integer	No	Port listener yang dipetakan ke port titik akhir. Catatan Kelompok titik akhir virtual listener TCP tidak mendukung pemetaan port. 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 mengonfigurasi pemetaan port, Anda tidak dapat mengubah protokol listener, kecuali beralih antara HTTP dan HTTPS. Range port listener yang Anda ubah harus mencakup semua port listener yang digunakan untuk pemetaan port. Misalnya, jika range port listener adalah 80–82 dan Anda memetakan port 100–102 ke titik akhir, Anda tidak dapat mengubah range port listener menjadi 80–81.	443
EndpointPort	integer	No	Port titik akhir yang dipetakan ke port listener.	80
HealthCheckEnabled	boolean	No	Menentukan apakah fitur pemeriksaan kesehatan diaktifkan. Nilai yang valid: true: mengaktifkan fitur pemeriksaan kesehatan. false: menonaktifkan fitur pemeriksaan kesehatan.	true
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. Kunci tag dapat memiliki panjang maksimal 64 karakter dan tidak boleh dimulai dengan `aliyun` atau `acs:`. Tidak boleh berisi `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. Nilai tag dapat memiliki panjang maksimal 128 karakter dan tidak boleh dimulai dengan `aliyun` atau `acs:`. Tidak boleh berisi `http://` atau `https://`. Anda dapat menentukan hingga 20 nilai tag.	test-value
DryRun	boolean	No	Menentukan apakah akan melakukan dry run. Nilai yang valid: true: melakukan dry run dan tidak membuat kelompok titik akhir. Sistem memeriksa permintaan terhadap potensi masalah, termasuk nilai parameter yang hilang, sintaksis permintaan yang salah, 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): mengirim permintaan. Jika permintaan lolos pemeriksaan, kode status HTTP 2xx dikembalikan dan kelompok titik akhir dibuat.	false
HealthCheckHost	string	No	Nama domain yang digunakan untuk pemeriksaan kesehatan.	www.taobao.com

Elemen respons

Element	Type	Description	Example
	object	Data yang dikembalikan.
EndpointGroupId	string	ID kelompok titik akhir.	epg-bp1dmlohjjz4kqaun****
RequestId	string	ID permintaan.	04F0F334-1335-436C-A1D7-6C044FE73368

Contoh

Respons sukses

JSONformat

{
  "EndpointGroupId": "epg-bp1dmlohjjz4kqaun****",
  "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368"
}

Kode kesalahan

HTTP status code	Error code	Error message
400	Domain.NotFit	The domain is not fit the rule
400	Resource.QuotaFull	The resource quota is exceeded.
400	NotExist.ListenerPort	The listening port %s does not exist.
400	NoPermission.EnableHealthCheck	You do not have permission to enable health check.
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	Exist.EndpointGroup	The endpoint group already exists.
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.
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.