Membuat Pendengar HTTPS.
Deskripsi operasi
Catatan Penting
Pendengar yang baru dibuat berada dalam status stopped. Setelah Anda membuat Pendengar, panggil operasi StartLoadBalancerListener untuk memulai Pendengar agar dapat meneruskan Trafik.
Sebelum Anda memulai
Instans Classic Load Balancer (CLB) telah dibuat. Untuk informasi selengkapnya, lihat CreateLoadBalancer.
Coba sekarang
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
slb:CreateLoadBalancerHTTPSListener |
create |
*acl
*certificate
*loadbalancer
|
|
None |
Parameter permintaan
|
Parameter |
Type |
Required |
Description |
Example |
| RegionId |
string |
No |
ID wilayah instans CLB. Anda dapat mengkueri ID wilayah dari daftar Wilayah dan zona atau dengan memanggil operasi DescribeRegions. |
cn-hangzhou |
| LoadBalancerId |
string |
Yes |
ID instans CLB. |
lb-bp1o94dp5i6earr**** |
| Bandwidth |
integer |
Yes |
Bandwidth puncak Pendengar. Unit: Mbit/s. Nilai valid:
|
-1 |
| ListenerPort |
integer |
Yes |
Port antarmuka depan yang digunakan oleh instans. Nilai valid: 1 hingga 65535. |
80 |
| BackendServerPort |
integer |
No |
Port backend yang digunakan oleh instans. Nilai valid: 1 hingga 65535. Parameter ini wajib diisi jika Anda tidak menggunakan kelompok vServer (VServerGroupId tidak ditentukan). |
80 |
| Tag |
array<object> |
No |
Tag. |
|
|
object |
No |
Tag. |
||
| Key |
string |
No |
kunci tag Pendengar. Nilai valid untuk N: 1 hingga 20. kunci tag tidak boleh berupa string kosong. Panjang kunci tag maksimal 64 karakter dan tidak boleh diawali dengan |
TestKey |
| Value |
string |
No |
nilai tag Pendengar. Nilai valid untuk N: 1 hingga 20. nilai tag dapat berupa string kosong. Panjang nilai tag maksimal 128 karakter dan tidak boleh diawali dengan |
TestValue |
| XForwardedFor |
string |
No |
Apakah akan menggunakan header
|
on |
| Scheduler |
string |
No |
Algoritma penjadwalan. Nilai valid:
|
wrr |
| StickySession |
string |
No |
Apakah akan mengaktifkan persistensi sesi. Nilai valid:
|
on |
| StickySessionType |
string |
No |
Metode yang digunakan untuk handle cookie. Nilai valid: insert dan server.
Saat Klien mengakses Instans Server Load Balancer untuk pertama kalinya, Instans Server Load Balancer menyisipkan cookie ke dalam tanggapan (menyisipkan SERVERID ke dalam tanggapan HTTP/HTTPS). Saat Klien mengirimkan permintaan berikutnya dengan cookie ini, Instans Server Load Balancer meneruskan permintaan ke server backend yang sebelumnya tercatat.
Saat Instans Server Load Balancer mendeteksi cookie yang ditentukan pengguna, Instans tersebut menulis ulang cookie asli. Saat Klien mengirimkan permintaan berikutnya dengan cookie baru, Instans Server Load Balancer meneruskan permintaan ke server backend yang sebelumnya tercatat. Catatan
Parameter ini wajib diisi ketika StickySession diatur ke on. |
insert |
| CookieTimeout |
integer |
No |
periode waktu tunggu cookie. Unit: detik. Nilai valid: 1 hingga 86400. Catatan
Parameter ini wajib diisi ketika StickySession diatur ke on dan StickySessionType diatur ke insert. |
500 |
| Cookie |
string |
No |
Cookie yang dikonfigurasi pada server. Panjang cookie harus 1 hingga 200 karakter dan hanya dapat berisi huruf dan angka ASCII. Cookie tidak boleh mengandung koma (,), titik koma (;), atau spasi. Cookie tidak boleh diawali dengan tanda dolar ($). Catatan
Parameter ini wajib diisi ketika StickySession diatur ke on dan StickySessionType diatur ke server. |
testCookie |
| HealthCheck |
string |
Yes |
Apakah akan mengaktifkan pemeriksaan kesehatan. Nilai valid:
|
on |
| HealthCheckMethod |
string |
No |
Metode pemeriksaan kesehatan yang digunakan oleh pemeriksaan kesehatan HTTP. Nilai valid: head dan get. Catatan
Parameter ini hanya berlaku ketika HealthCheck diatur ke on. |
get |
| HealthCheckDomain |
string |
No |
Nama domain yang digunakan untuk Pemeriksaan kesehatan. Nilai valid:
Catatan
Parameter ini hanya berlaku ketika HealthCheck diatur ke on. |
172.XX.XX.16 |
| HealthCheckURI |
string |
No |
URI yang digunakan untuk pemeriksaan kesehatan. Panjang URI harus 1 hingga 80 karakter dan dapat berisi huruf, angka, serta karakter khusus berikut: Catatan
Parameter ini hanya berlaku ketika HealthCheck diatur ke on. |
/test/index.html |
| HealthyThreshold |
integer |
No |
Jumlah pemeriksaan kesehatan berhasil berturut-turut yang harus terjadi sebelum server backend dinyatakan sehat (dari fail ke success). Nilai valid: 2 hingga 10. Catatan
Parameter ini hanya berlaku ketika HealthCheck diatur ke on. |
4 |
| UnhealthyThreshold |
integer |
No |
Jumlah pemeriksaan kesehatan gagal berturut-turut yang harus terjadi sebelum server backend dinyatakan tidak sehat (dari success ke fail). Nilai valid: 2 hingga 10. Catatan
Parameter ini hanya berlaku ketika HealthCheck diatur ke on. |
4 |
| HealthCheckTimeout |
integer |
No |
Jumlah waktu tunggu untuk menunggu tanggapan dari Pemeriksaan kesehatan. Jika Instans ECS Backend tidak merespons dalam waktu tunggu yang ditentukan, Pemeriksaan kesehatan gagal. Unit: detik. Nilai valid: 1 hingga 300. Catatan
Parameter ini hanya berlaku ketika HealthCheck diatur ke on. |
3 |
| HealthCheckConnectPort |
integer |
No |
Port yang digunakan untuk pemeriksaan kesehatan. Nilai valid: 1 hingga 65535. Catatan
Parameter ini hanya berlaku ketika HealthCheck diatur ke on. |
8080 |
| HealthCheckInterval |
integer |
No |
Interval antara dua pemeriksaan kesehatan berturut-turut. Unit: detik. Nilai valid: 1 hingga 50. Catatan
Parameter ini hanya berlaku ketika HealthCheck diatur ke on. |
5 |
| HealthCheckHttpCode |
string |
No |
Kode status HTTP yang menunjukkan pemeriksaan kesehatan berhasil. Pisahkan beberapa kode status dengan koma (,). Nilai valid: http_2xx, http_3xx, http_4xx, dan http_5xx. Catatan
Parameter ini hanya berlaku ketika HealthCheck diatur ke on. |
http_2xx,http_3xx |
| ServerCertificateId |
string |
No |
ID sertifikat server. |
idkp-123-cn-test-**** |
| VServerGroupId |
string |
No |
ID kelompok vServer. |
rsp-cige6j5e7p**** |
| CACertificateId |
string |
No |
ID sertifikat CA. Jika Anda mengunggah sertifikat CA dan sertifikat server, otentikasi timbal balik digunakan. Jika Anda hanya mengunggah sertifikat server, otentikasi satu arah digunakan. |
139a00604ad-cn-east-hangzh**** |
| XForwardedFor_SLBIP |
string |
No |
Apakah akan menggunakan header
|
on |
| XForwardedFor_SLBID |
string |
No |
Apakah akan menggunakan Header
|
on |
| XForwardedFor_proto |
string |
No |
Apakah akan menggunakan Header
|
on |
| Gzip |
string |
No |
Apakah akan mengaktifkan kompresi
|
on |
| AclId |
string |
No |
ID daftar kontrol akses (ACL) yang terikat ke pendengar. Catatan
Parameter ini wajib diisi ketika AclStatus diatur ke on. |
acl-a2do9e413e0spzasx**** |
| AclType |
string |
No |
Tipe kontrol akses. Nilai valid:
Jika daftar putih diaktifkan tetapi tidak ada alamat IP yang ditambahkan ke kelompok kebijakan kontrol akses, pendengar SLB meneruskan semua permintaan.
Jika blacklist diaktifkan tetapi tidak ada alamat IP yang ditambahkan ke kelompok kebijakan kontrol akses, pendengar SLB meneruskan semua permintaan. Catatan
Parameter ini hanya berlaku ketika AclStatus diatur ke on. |
white |
| AclStatus |
string |
No |
Apakah akan mengaktifkan kontrol akses. Nilai valid:
|
off |
| Description |
string |
No |
Nama Pendengar kustom. Panjang nama harus 1 hingga 256 karakter dan dapat berisi karakter Tionghoa, huruf, angka, tanda hubung (-), garis miring (/), titik (.), dan garis bawah (_). |
HTTPS_443 |
| IdleTimeout |
integer |
No |
periode waktu tunggu koneksi idle. Nilai valid: 1 hingga 60. Nilai default: 15. Unit: detik. Jika tidak ada permintaan akses yang diterima dalam waktu tunggu yang ditentukan, Instans Server Load Balancer akan memutus sementara koneksi saat ini dan membuat kembali koneksi baru saat permintaan berikutnya tiba. |
12 |
| RequestTimeout |
integer |
No |
periode waktu tunggu permintaan. Nilai valid: 1 hingga 180. Nilai default: 60. Unit: detik. Jika tidak ada tanggapan yang diterima dari server backend dalam waktu tunggu yang ditentukan, Instans Server Load Balancer berhenti menunggu dan mengembalikan kode kesalahan HTTP 504 ke Klien. |
23 |
| EnableHttp2 |
string |
No |
Apakah akan mengaktifkan fitur HTTP/2. Nilai valid:
|
off |
| TLSCipherPolicy |
string |
No |
Kebijakan keamanan yang berisi versi protokol TLS dan rangkaian algoritma enkripsi yang didukung untuk HTTPS.
|
tls_cipher_policy_1_1 |
| XForwardedFor_SLBPORT |
string |
No |
Apakah akan menggunakan Header
|
off |
| XForwardedFor_ClientSrcPort |
string |
No |
Apakah akan menggunakan header
|
off |
Elemen respons
|
Element |
Type |
Description |
Example |
|
object |
|||
| RequestId |
string |
ID permintaan. |
CEF72CEB-54B6-4AE8-B225-F876FF7BA984 |
Contoh
Respons sukses
JSONformat
{
"RequestId": "CEF72CEB-54B6-4AE8-B225-F876FF7BA984"
}
Kode kesalahan
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | ParamDuplicateError | The specified parameter value of XForwardedFor_ClientCertSubjectDNAlias is duplicate. Please change to a different one. | Parameter XForwardedFor_ClientCertClientVerifyAlias duplikat. |
| 400 | IpVersionConflict | The ip version of this LoadBalancer and the Acl is conflict. | Versi IP Instance SLB yang ditentukan bentrok dengan tipe IP yang didukung oleh ACL. |
| 400 | InvalidParameter.IdleTimeout | The specified IdleTimeout exceeds the limit. | IdleTimeout yang ditentukan tidak valid. Periksa batasan parameter dan coba lagi setelah melakukan koreksi. |
| 400 | InvalidParameter.RequestTimeout | The specified RequestTimeout exceeds the limit. | RequestTimeout yang ditentukan tidak valid. Periksa batasan parameter dan coba lagi. |
| 400 | ListenerForwardNotSupport | X-Forward-For is not supported to a ipv6 instance. | Instance SLB IPv6 tidak mendukung X-Forwarded-For. |
| 400 | InvalidParameter.RegionNotSupport | The region does not support the parameter: %s. | Parameter yang ditentukan tidak didukung di wilayah saat ini. |
| 400 | InvalidParameter.SpecNotSupport | The loadBalancer of shared spec does not support the parameter: %s. | Parameter yang ditentukan tidak didukung oleh Instans SLB sumber daya bersama. |
| 400 | ListenerProcessing | A previous configuration of the listener is pending,please try again later. | Pendengar saat ini sedang dikonfigurasi. Coba lagi nanti. |
| 400 | Certkey.Forbidden | The specified certkey is not owned by the current user. | Sertifikat dan kunci yang ditentukan bukan milik pengguna saat ini. |
| 400 | InvalidParameter.ListenerPortConflict | There is conflict listener port exists. | Port Pendengar yang ditentukan sudah ada. |
| 400 | ResourceNotAvailible.HttpsListener | The specified Zone did not have enough resource. | Sumber daya tidak mencukupi di zona yang ditentukan. |
| 400 | AclNotExist | Acl does not exist. | ACL yang ditentukan tidak ada. |
| 400 | OperationUnsupported.CreateLoadBalancerLayer7Listener | The slb instance does not support create HTTP or HTTPS listener. | Instance SLB saat ini tidak mendukung pembuatan pendengar HTTP atau HTTPS. |
| 400 | InvalidParameter.VServerGroupId | The MasterSlaveServerGroup can not be attached to HTTP or HTTPS listener. | Pendengar HTTP atau HTTPS tidak mendukung kelompok server primer/server sekunder. |
| 400 | MissingParam.HealthCheckDomain | The HealthCheckDomain is required when HealthCheckHttpVersion is http1.1. | Parameter HealthCheckDomain tidak disertakan. |
| 400 | InvalidParameter.HealthCheckHttpVersion | The param HealthCheckHttpVersion is invalid. | HealthCheckHttpVersion yang ditentukan tidak valid. Periksa batasan parameter dan coba lagi setelah melakukan koreksi. |
| 400 | Duplicated.AclEntry | %s. | %s |
| 400 | CertificateNotExist | The specified CertificateId does not exist. | Sertifikat yang ditentukan tidak ada. |
| 400 | OperationFailed.InsufficientResources | The loadbalancer does not support this operation because of insufficient resources. | Operasi gagal karena Instans Server Load Balancer tidak mendukung operasi ini akibat sumber daya yang tidak mencukupi. |
| 400 | InvalidTLSPolicyId.NotExist | The specified TLS cipher policy does not exist. | Kebijakan keamanan TLS yang ditentukan tidak ada. |
| 400 | TLSPolicyConfiguring | The specified TLS cipher policy is configuring. | TLSCipherPolicy yang ditentukan sedang dimodifikasi. |
| 400 | TLSCipherPolicyVipRelationOverLimit | The number of listeners associated with a policy has exceeded. | Jumlah instans TLSCipherPolicy yang terkait dengan pendengar telah mencapai batas kuota. |
| 400 | CertificateTypeMismatched | The certificate type does not match. | Tipe Sertifikat yang ditentukan tidak cocok. |
| 400 | MissingParam.ServerCertificates | Server certificates are required. | Parameter ServerCertificates tidak disertakan. |
| 400 | TooManyCertificates | The number of certificates must not be greater than one. | Jumlah sertifikat tidak boleh melebihi 1. |
| 400 | CnCertificateNotSupport | The cn certificate is not support. | Sertifikat Algoritma Kriptografi Nasional Tiongkok (SM) tidak didukung. |
| 400 | InvalidParam.CertificateBindingType | The param CertificateBindingType is invalid. | CertificateBindingType yang ditentukan tidak valid. Periksa batasan parameter dan coba lagi setelah Anda melakukan modifikasi. |
| 400 | InvalidParamSize.ServerCertificates | The size of param ServerCertificates is invalid. | Panjang ServerCertificates yang ditentukan tidak valid. Periksa batasan parameter dan coba lagi. |
| 400 | TooManyCertificates.ServerCertificates | The number of certificates must not be greater than one. | Jumlah sertifikat tidak boleh melebihi 1. |
| 400 | SPEC_NOT_SUPPORT_PARAMETER | Share spec does not support the feature. | |
| 400 | LbNotSupportTcpssl | You cannot create a TCP SSL type listener for the specified load balancer. | Instans yang ditentukan tidak mendukung pembuatan pendengar tipe TCP/SSL. |
| 400 | LbSupportTcpsslOnly | The specified load balancer supports TCP SSL type listener only. | Instans yang ditentukan hanya mendukung pembuatan pendengar tipe TCP/SSL. |
| 400 | ListenerNotSupportRule | You cannot create a rule for the specified listener. | Pendengar yang ditentukan tidak mendukung pembuatan aturan pengalihan. |
| 400 | Mismatch.SlbSpecTypeAndListenerProtocol | The SlbSpecType and ListenerProtocol are mismatched. | Tipe spesifikasi Instans tidak cocok dengan tipe pendengar. |
| 400 | InvalidParam.TagValue | %s. | |
| 400 | InvalidParam.TagKey | %s. | |
| 400 | SizeLimitExceeded.Tag | %s. | |
| 400 | MissingParam.TagKey | The param MissingParam.TagKey is missing. | |
| 400 | AclListenerOverLimit | This acl has reached the limit of binding to listeners. | Jumlah Pendengar yang dapat dikaitkan dengan ACL yang ditentukan telah mencapai batas Kuota. |
| 400 | QuotaLimitExceeds.AclAttachedToListener | The number of Acl bound listeners has reached the quota limit | Jumlah pendengar yang terkait dengan ACL telah mencapai batas kuota. |
| 400 | QuotaLimitExceeds.TotalAclEntry | The number of Acl entries has reached the quota limit. | Jumlah entri ACL telah mencapai batas kuota. |
| 400 | QuotaLimitExceeds.AclListenerOverLimit | This acl has reached the limit of binding to listeners. | Jumlah Pendengar yang dapat dikaitkan dengan ACL yang ditentukan telah mencapai batas Kuota. |
| 404 | ResourceNotFound.Certificate | The specified resource is not found. |
Lihat Error Codes untuk daftar lengkap.
Catatan rilis
Lihat Release Notes untuk daftar lengkap.