All Products
Search

This Product

    Server Load Balancer:SetLoadBalancerHTTPSListenerAttribute

    Document Center

    Server Load Balancer:SetLoadBalancerHTTPSListenerAttribute

    Last Updated:Oct 28, 2026

    Mengubah konfigurasi Pendengar HTTPS.

    Deskripsi operasi

    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

    slb:SetLoadBalancerHTTPSListenerAttribute

    update

    acl.

    acs:slb:{#regionId}:{#accountId}:acl/{#aclId}

    *Sertifikat

    acs:slb:{#regionId}:{#accountId}:certificate/{#certificateId}

    *loadbalancer.

    acs:slb:{#regionId}:{#accountId}:loadbalancer/{#loadbalancerId}
    • slb:tag
    • slb:tag
    • slb:tag
    		 None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    No

    ID wilayah Instans SLB.

    Anda dapat memanggil operasi DescribeRegions untuk mengkueri ID wilayah.

    cn-hangzhou
    LoadBalancerId

    string

    Yes

    ID Instans SLB.

    lb-sjhfdji****
    ListenerPort

    integer

    Yes

    Port antarmuka depan yang digunakan oleh Instans SLB.

    Nilai valid: 1 hingga 65535.

    80
    Bandwidth

    integer

    No

    Bandwidth maksimum Pendengar. Unit: Mbit/s.

    Nilai valid:

    • -1: Bandwidth maksimum tidak dibatasi.

    -1
    XForwardedFor

    string

    No

    Apakah akan menggunakan header X-Forwarded-For untuk mendapatkan alamat IP asli klien. Nilai valid:

    • on: ya.

    • off: tidak.

    on
    Scheduler

    string

    No

    Algoritma penjadwalan. Nilai valid:

    • wrr: Server backend dengan bobot lebih tinggi menerima lebih banyak permintaan.

    • rr: Permintaan didistribusikan secara merata dan berurutan ke server backend.

    wrr
    StickySession

    string

    No

    Apakah akan mengaktifkan persistensi sesi. Nilai valid:

    • on: ya.

    • off: tidak.

    on
    StickySessionType

    string

    No

    Metode yang digunakan untuk handle cookie. Nilai valid:

    • insert: memasukkan cookie.

      Saat Klien mengakses SLB untuk pertama kalinya, SLB memasukkan cookie ke dalam tanggapan (yaitu, SLB memasukkan bidang SERVERID ke dalam tanggapan HTTP atau HTTPS). Saat Klien mengakses SLB berikutnya dengan cookie ini, SLB meneruskan permintaan ke server Backend yang tercatat.

    • server: menulis ulang cookie.

      Saat SLB mendeteksi cookie yang ditentukan pengguna, SLB menulis ulang cookie asli. Saat Klien mengakses SLB berikutnya dengan cookie baru ini, SLB meneruskan permintaan ke server Backend yang tercatat.

    Catatan

    Parameter ini wajib diisi saat StickySession diatur ke on.

    insert
    CookieTimeout

    integer

    No

    Periode pengatur waktu cookie.

    Nilai valid: 1 hingga 86400. Unit: detik.

    Catatan

    Parameter ini wajib diisi saat 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 serta digit ASCII. Cookie tidak boleh mengandung koma (,), titik koma (;), atau spasi, dan tidak boleh diawali dengan tanda dolar ($).

    Catatan

    Parameter ini wajib diisi saat StickySession diatur ke on dan StickySessionType diatur ke server.

    testCookie
    HealthCheck

    string

    No

    Apakah akan mengaktifkan fitur pemeriksaan kesehatan. Nilai valid:

    • on: ya.

    • off: tidak.

    on
    HealthCheckMethod

    string

    No

    Metode HTTP yang digunakan untuk pemeriksaan kesehatan. Nilai valid: head dan get.

    Catatan

    Parameter ini hanya berlaku saat HealthCheck diatur ke on.

    get
    HealthCheckDomain

    string

    No

    Nama domain yang digunakan untuk Pemeriksaan kesehatan. Nilai valid:

    • $_ip: Alamat IP pribadi server Backend. Jika alamat IP ditentukan atau parameter ini tidak ditentukan, SLB menggunakan alamat IP pribadi server Backend sebagai Nama domain untuk Pemeriksaan kesehatan.

    • domain: Panjang Nama domain harus 1 hingga 80 karakter dan hanya dapat berisi huruf, digit, titik (.), dan tanda hubung (-).

    Catatan

    Parameter ini hanya berlaku saat 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, digit, tanda hubung (-), garis miring (/), titik (.), tanda persen (%), tanda tanya (?), tanda pagar (#), dan ampersand (&). URI tidak boleh hanya berisi garis miring (/) tetapi harus diawali dengan garis miring (/).

    Catatan

    Parameter ini hanya berlaku saat 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 saat 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 saat HealthCheck diatur ke on.

    4
    HealthCheckTimeout

    integer

    No

    Periode pengatur waktu tanggapan Pemeriksaan kesehatan. Jika Instans ECS Backend tidak mengirimkan tanggapan yang benar dalam pengatur waktu yang ditentukan, Pemeriksaan kesehatan gagal. Unit: detik. Nilai valid: 1 hingga 300.

    Catatan

    Parameter ini hanya berlaku saat HealthCheck diatur ke on.

    3
    HealthCheckInterval

    integer

    No

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

    Nilai valid: 1 hingga 50.

    Catatan

    Parameter ini hanya berlaku saat HealthCheck diatur ke on.

    5
    HealthCheckConnectPort

    integer

    No

    Port yang digunakan untuk pemeriksaan kesehatan.

    Nilai valid: 1 hingga 65535.

    Catatan

    Parameter ini hanya berlaku saat HealthCheck diatur ke on.

    8080
    HealthCheckHttpCode

    string

    No

    Kode status HTTP yang menunjukkan pemeriksaan kesehatan berhasil. Pisahkan beberapa kode status HTTP dengan koma (,).

    Nilai valid: http_2xx, http_3xx, http_4xx, dan http_5xx.

    Catatan

    Parameter ini hanya berlaku saat HealthCheck diatur ke on.

    http_2xx,http_3xx
    ServerCertificateId

    string

    No

    ID sertifikat server.

    idkp-123-cn-te****
    CACertificateId

    string

    No

    ID sertifikat otoritas sertifikat (CA).

    • Jika sertifikat CA dan sertifikat server diunggah, otentikasi timbal balik digunakan.

    • Jika hanya sertifikat server yang diunggah, otentikasi satu arah digunakan.

    139a00604ad-cn-east-****
    VServerGroup

    string

    No

    Apakah akan menggunakan kelompok vServer. Nilai valid:

    • on: ya.

    • off: tidak.

    on
    VServerGroupId

    string

    No

    ID kelompok vServer.

    rsp-cige6j****
    XForwardedFor_SLBIP

    string

    No

    Apakah akan menggunakan header SLB-IP untuk mendapatkan alamat IP virtual (VIP) yang diminta oleh klien. Nilai valid:

    • on: ya.

    • off: tidak.

    on
    XForwardedFor_SLBID

    string

    No

    Apakah ID Instans SLB diperoleh melalui Header SLB-ID. Nilai valid:

    • on: ya.

    • off: tidak.

    on
    XForwardedFor_proto

    string

    No

    Apakah protokol Pendengar Instans SLB diperoleh melalui Header X-Forwarded-Proto. Nilai valid:

    • on: ya.

    • off: tidak.

    on
    Gzip

    string

    No

    Apakah akan mengaktifkan kompresi Gzip untuk mengompresi jenis file tertentu. Nilai valid:

    • on: ya.

    • off: tidak.

    on
    AclId

    string

    No

    ID daftar kontrol akses (ACL) tempat pendengar terikat.

    Parameter ini wajib diisi saat AclStatus diatur ke on.

    acl-a2do9e413e0spzasx****
    AclType

    string

    No

    Jenis Kontrol akses. Nilai valid:

    • white: Hanya permintaan dari alamat IP atau blok CIDR dalam Pengaturan kelompok kebijakan Kontrol akses yang dipilih yang diteruskan. daftar putih berlaku untuk skenario di mana Anda hanya ingin mengizinkan alamat IP tertentu mengakses aplikasi. Risiko dapat muncul jika Anda mengonfigurasi daftar putih. Setelah daftar putih dikonfigurasi, hanya alamat IP dalam daftar putih yang dapat mengakses Pendengar SLB.

      Jika Anda mengaktifkan daftar putih tetapi kelompok kebijakan Kontrol akses tidak berisi alamat IP apa pun, Pendengar SLB meneruskan semua permintaan.

    • black: Tidak ada permintaan dari alamat IP atau blok CIDR dalam Pengaturan kelompok kebijakan Kontrol akses yang dipilih yang diteruskan. blacklist berlaku untuk skenario di mana Anda ingin memblokir akses dari alamat IP tertentu ke aplikasi.

      Jika Anda mengaktifkan blacklist tetapi kelompok kebijakan Kontrol akses tidak berisi alamat IP apa pun, Pendengar SLB meneruskan semua permintaan.

    Catatan

    Parameter ini hanya berlaku saat AclStatus diatur ke on.

    white
    AclStatus

    string

    No

    Apakah akan mengaktifkan fitur kontrol akses. Nilai valid:

    • on: ya.

    • off: tidak.

    off
    IdleTimeout

    integer

    No

    Periode pengatur waktu koneksi tidak aktif. Nilai valid: 1 hingga 60. Unit: detik. Nilai default: 15.

    Jika tidak ada permintaan akses yang diterima dalam pengatur waktu yang ditentukan, SLB memutuskan koneksi saat ini untuk sementara. Saat permintaan lain diterima, SLB membuat koneksi baru.

    23
    RequestTimeout

    integer

    No

    Periode pengatur waktu permintaan. Nilai valid: 1 hingga 180. Unit: detik. Nilai default: 60.

    Jika server Backend tidak mengirimkan tanggapan dalam pengatur waktu yang ditentukan, SLB berhenti menunggu dan mengembalikan kode kesalahan HTTP 504 ke Klien.

    223
    EnableHttp2

    string

    No

    Apakah akan mengaktifkan fitur HTTP/2. Nilai valid:

    • on: ya.

    • off: tidak.

    off
    TLSCipherPolicy

    string

    No

    Kebijakan keamanan yang berisi versi protokol TLS yang tersedia dan rangkaian algoritma enkripsi yang didukung untuk HTTPS.

    • tls_cipher_policy_1_0:

      Versi TLS yang didukung: TLSv1.0, TLSv1.1, dan TLSv1.2.

      Rangkaian algoritma enkripsi yang didukung: ECDHE-RSA-AES128-GCM-SHA256, ECDHE-RSA-AES256-GCM-SHA384, ECDHE-RSA-AES128-SHA256, ECDHE-RSA-AES256-SHA384, AES128-GCM-SHA256, AES256-GCM-SHA384, AES128-SHA256, AES256-SHA256, ECDHE-RSA-AES128-SHA, ECDHE-RSA-AES256-SHA, AES128-SHA, AES256-SHA, dan DES-CBC3-SHA.

    • tls_cipher_policy_1_1:

      Versi TLS yang didukung: TLSv1.1 dan TLSv1.2.

      Rangkaian algoritma enkripsi yang didukung: ECDHE-RSA-AES128-GCM-SHA256, ECDHE-RSA-AES256-GCM-SHA384, ECDHE-RSA-AES128-SHA256, ECDHE-RSA-AES256-SHA384, AES128-GCM-SHA256, AES256-GCM-SHA384, AES128-SHA256, AES256-SHA256, ECDHE-RSA-AES128-SHA, ECDHE-RSA-AES256-SHA, AES128-SHA, AES256-SHA, dan DES-CBC3-SHA.

    • tls_cipher_policy_1_2:

      Versi TLS yang didukung: TLSv1.2.

      Rangkaian algoritma enkripsi yang didukung: ECDHE-RSA-AES128-GCM-SHA256, ECDHE-RSA-AES256-GCM-SHA384, ECDHE-RSA-AES128-SHA256, ECDHE-RSA-AES256-SHA384, AES128-GCM-SHA256, AES256-GCM-SHA384, AES128-SHA256, AES256-SHA256, ECDHE-RSA-AES128-SHA, ECDHE-RSA-AES256-SHA, AES128-SHA, AES256-SHA, dan DES-CBC3-SHA.

    • tls_cipher_policy_1_2_strict:

      Versi TLS yang didukung: TLSv1.2.

      Rangkaian algoritma enkripsi yang didukung: ECDHE-RSA-AES128-GCM-SHA256, ECDHE-RSA-AES256-GCM-SHA384, ECDHE-RSA-AES128-SHA256, ECDHE-RSA-AES256-SHA384, ECDHE-RSA-AES128-SHA, dan ECDHE-RSA-AES256-SHA.

    • tls_cipher_policy_1_2_strict_with_1_3:

      Versi TLS yang didukung: TLSv1.2 dan TLSv1.3.

      Rangkaian algoritma enkripsi yang didukung: TLS_AES_128_GCM_SHA256, TLS_AES_256_GCM_SHA384, TLS_CHACHA20_POLY1305_SHA256, TLS_AES_128_CCM_SHA256, TLS_AES_128_CCM_8_SHA256, ECDHE-ECDSA-AES128-GCM-SHA256, ECDHE-ECDSA-AES256-GCM-SHA384, ECDHE-ECDSA-AES128-SHA256, ECDHE-ECDSA-AES256-SHA384, ECDHE-RSA-AES128-GCM-SHA256, ECDHE-RSA-AES256-GCM-SHA384, ECDHE-RSA-AES128-SHA256, ECDHE-RSA-AES256-SHA384, ECDHE-ECDSA-AES128-SHA, ECDHE-ECDSA-AES256-SHA, ECDHE-RSA-AES128-SHA, dan ECDHE-RSA-AES256-SHA.

    tls_cipher_policy_1_2
    Description

    string

    No

    Nama Pendengar kustom. Panjangnya harus 1 hingga 256 karakter dan dapat berisi karakter Mandarin, huruf, digit, tanda hubung (-), garis miring (/), titik (.), dan garis bawah (_).

    https_80
    XForwardedFor_SLBPORT

    string

    No

    Apakah Port Pendengar Instans SLB diperoleh melalui Header XForwardedFor_SLBPORT. Nilai valid:

    • on: ya.

    • off: tidak.

    off
    XForwardedFor_ClientSrcPort

    string

    No

    Apakah Port Klien yang mengakses Instans SLB diperoleh melalui Header XForwardedFor_ClientSrcPort. Nilai valid:

    • on: ya.

    • off: tidak.

    off
    DryRun

    boolean

    No

    Apakah akan menjalankan dry run pada permintaan.

    • true: menjalankan dry run dan tidak menjalankan operasi aktual. Jika permintaan lulus dry run, kode kesalahan DryRunOperation dikembalikan.

    • false: menjalankan dry run dan menjalankan operasi aktual jika permintaan lulus dry run.

    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 OperationFailed.ServerGroupInUse The VServerGroup or MasterSlaveServerGroup can not be close for this listener. Operasi gagal karena pendengar saat ini tidak mendukung penonaktifan kelompok server.
    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 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 TooManyCertificates The number of certificates must not be greater than one. Jumlah sertifikat tidak boleh melebihi 1.
    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 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 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.
    400 DryRunOperation Request validation has been passed with DryRun flag set. Permintaan DryRun telah lulus validasi.
    404 ResourceNotFound.Certificate The specified resource is not found.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.