All Products
Search

This Product

    ENS:DescribeLoadBalancerHTTPSListenerAttribute

    Document Center

    ENS:DescribeLoadBalancerHTTPSListenerAttribute

    Last Updated:Jun 11, 2026

    Memanggil DescribeLoadBalancerHTTPSListenerAttribute untuk meminta konfigurasi listener HTTPS.

    Deskripsi operasi

    • Frekuensi panggilan API: 100 panggilan per detik.

    • Frekuensi panggilan per pengguna: 10 panggilan per detik.

    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

    ens:DescribeLoadBalancerHTTPSListenerAttribute

    get

    *全部资源

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    ListenerPort

    integer

    Yes

    Port listener yang akan diminta. Nilai yang valid: 1 hingga 65535.

    443
    LoadBalancerId

    string

    Yes

    ID instance Server Load Balancer (SLB).

    lb-5qoxu2rsr0ytanpn4r3i****

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Skema Respons

    RequestId

    string

    ID permintaan.

    473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
    ListenerPort

    integer

    Port frontend yang digunakan oleh instance SLB. Nilai yang valid: 1 hingga 65535.

    8080
    Status

    string

    Status listener saat ini. Nilai yang valid:

    • Running: Listener berjalan secara normal.

    • Stopped: Listener telah dihentikan.

    • Starting: Listener sedang dimulai.

    • Configuring: Listener sedang dikonfigurasi.

    • Stopping: Listener sedang dihentikan.

    Running
    Bandwidth

    integer

    Bandwidth puncak dari instance SLB. Nilai default adalah -1, yang menunjukkan bahwa bandwidth tidak dibatasi.

    50
    Scheduler

    string

    Algoritme penjadwalan. Nilai yang valid:

    • wrr: Server backend dengan nilai bobot lebih tinggi menerima lebih banyak permintaan daripada yang memiliki nilai bobot lebih rendah.

    • wlc: Selain nilai bobot yang diatur untuk setiap server backend, beban aktual (yaitu, jumlah koneksi) dari server backend juga dipertimbangkan. Ketika nilai bobot sama, server backend dengan jumlah koneksi saat ini yang lebih sedikit menerima lebih banyak permintaan.

    • rr: Permintaan eksternal didistribusikan ke server backend secara berurutan berdasarkan urutan akses.

    • sch: Hashing konsisten berdasarkan alamat IP sumber. Permintaan dari alamat IP sumber yang sama dijadwalkan ke server backend yang sama.

    • qch: Hashing konsisten berdasarkan QUIC Connection ID. Permintaan dengan QUIC Connection ID yang sama dijadwalkan ke server backend yang sama.

    • iqch: Hashing konsisten berdasarkan tiga byte spesifik dari iQUIC CID. Permintaan yang byte ke-2 hingga ke-4 nya sama dijadwalkan ke server backend yang sama.

    wrr
    HealthCheck

    string

    Menentukan apakah akan mengaktifkan fitur pemeriksaan kesehatan. Nilai yang valid:

    • on: diaktifkan.

    • off: dinonaktifkan.

    on
    HealthyThreshold

    integer

    Jumlah pemeriksaan kesehatan berhasil berturut-turut yang harus terjadi sebelum status pemeriksaan kesehatan server backend diubah dari fail (server backend tidak dapat dijangkau) menjadi success (server backend dapat dijangkau). Nilai yang valid: 2 hingga 10.

    Catatan

    Parameter ini hanya berlaku ketika HealthCheck diatur ke on.

    3
    UnhealthyThreshold

    integer

    Jumlah pemeriksaan kesehatan gagal berturut-turut yang harus terjadi sebelum status pemeriksaan kesehatan server backend diubah dari success (server backend dapat dijangkau) menjadi fail (server backend tidak dapat dijangkau). Nilai yang valid: 2 hingga 10.

    Catatan

    Parameter ini hanya berlaku ketika HealthCheck diatur ke on.

    3
    HealthCheckTimeout

    integer

    Jumlah waktu untuk menunggu respons dari pemeriksaan kesehatan. Jika instance ENS backend tidak merespons dalam periode waktu yang ditentukan, pemeriksaan kesehatan gagal.

    • Nilai default: 5 detik.

    • Nilai yang valid: 1 hingga 300.

    • Satuan: detik.

    Catatan

    • Parameter ini hanya berlaku ketika HealthCheck diatur ke on.

    • Jika nilai HealthCheckTimeout lebih kecil dari nilai HealthCheckInterval, HealthCheckTimeout menjadi tidak valid, dan nilai HealthCheckInterval digunakan sebagai periode batas waktu.

    5
    HealthCheckConnectPort

    integer

    Port yang digunakan untuk pemeriksaan kesehatan. Nilai yang valid: 1 hingga 65535. Jika parameter ini tidak diatur, port server backend (BackendServerPort) digunakan.

    Catatan

    Parameter ini hanya berlaku ketika HealthCheck diatur ke on.

    9902
    HealthCheckInterval

    integer

    Interval antara dua pemeriksaan kesehatan berturut-turut. Nilai yang valid: 1 hingga 50. Satuan: detik.

    Catatan

    Parameter ini hanya berlaku ketika HealthCheck diatur ke on.

    5
    Description

    string

    Deskripsi dari listener. Panjang harus 1 hingga 80 karakter.

    abc
    ListenerForward

    string

    Menentukan apakah akan mengaktifkan penerusan HTTP-ke-HTTPS. Nilai yang valid:

    • on: diaktifkan.

    • off: dinonaktifkan.

    off
    ForwardPort

    integer

    Port penerusan untuk listening HTTP-ke-HTTPS.

    0
    RequestTimeout

    integer

    Periode batas waktu permintaan. Nilai default: 60 detik. Nilai yang valid: 1 hingga 180. Satuan: detik.

    Catatan

    Jika tidak ada respons yang diterima dari server backend dalam periode batas waktu, SLB berhenti menunggu dan mengembalikan kode kesalahan HTTP 504 ke klien.

    60
    IdleTimeout

    integer

    Periode batas waktu koneksi menganggur. Nilai default: 15 detik. Nilai yang valid: 1 hingga 60. Satuan: detik.

    Catatan

    Jika tidak ada permintaan akses yang diterima dalam periode batas waktu, SLB sementara mengakhiri koneksi saat ini dan menjalin koneksi baru saat permintaan berikutnya tiba.

    15
    HealthCheckHttpCode

    string

    Kode status HTTP yang dikembalikan untuk pemeriksaan kesehatan yang berhasil. Nilai yang valid:

    • http_2xx (nilai default).

    • http_3xx.

    • http_4xx.

    • http_5xx.

    Catatan

    Parameter ini hanya berlaku ketika HealthCheck diatur ke on.

    http_2xx
    HealthCheckDomain

    string

    Nama domain yang digunakan untuk pemeriksaan kesehatan.

    Catatan

    Parameter ini hanya berlaku ketika HealthCheck diatur ke on.

    www.test.com
    HealthCheckURI

    string

    URI yang digunakan untuk pemeriksaan kesehatan. Panjang harus 1 hingga 80 karakter.

    • URL tidak boleh hanya /, tetapi harus diawali dengan /.

    • Parameter ini hanya berlaku ketika HealthCheck diatur ke on.

    /checkpreload.htm
    ServerCertificateId

    string

    ID dari sertifikat server.

    60276**
    HealthCheckMethod

    string

    Metode pemeriksaan kesehatan untuk pemeriksaan kesehatan bertipe HTTP pada listener. Nilai yang valid:

    • head: Hanya header halaman yang diminta.

    • get: Informasi halaman yang ditentukan diminta dan badan entitas dikembalikan.

    Catatan

    Parameter ini hanya berlaku ketika HealthCheck diatur ke on.

    head
    BackendServerPort

    integer

    Port yang digunakan oleh server backend dari instance SLB. Nilai yang valid: 1 hingga 65535.

    8080

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "ListenerPort": 8080,
  "Status": "Running",
  "Bandwidth": 50,
  "Scheduler": "wrr",
  "HealthCheck": "on",
  "HealthyThreshold": 3,
  "UnhealthyThreshold": 3,
  "HealthCheckTimeout": 5,
  "HealthCheckConnectPort": 9902,
  "HealthCheckInterval": 5,
  "Description": "abc",
  "ListenerForward": "off",
  "ForwardPort": 0,
  "RequestTimeout": 60,
  "IdleTimeout": 15,
  "HealthCheckHttpCode": "http_2xx",
  "HealthCheckDomain": "www.test.com",
  "HealthCheckURI": "/checkpreload.htm",
  "ServerCertificateId": "60276**",
  "HealthCheckMethod": "head",
  "BackendServerPort": 8080
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 LoadBalancerNotFound The input parameter loadBalancerId that is not found.
    400 ens.interface.error An error occurred while call the API.
    400 NoPermission Permission denied.
    400 InvalidParameter.%s The specified field %s invalid. Please check it again.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.