Tüm Ürünler
Search

Bu Ürün

    :DescribeLoadBalancerHTTPSListenerAttribute

    Belge Merkezi

    :DescribeLoadBalancerHTTPSListenerAttribute

    Son Güncelleme:Oct 01, 2026

    Bir HTTPS dinleyicisinin yapılandırmalarını sorgular.

    Operation description

    • hesap başına saniyede en fazla 100 kez.

    • kullanıcı başına saniyede en fazla 10 kez.

    Try it now

    Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

    Test

    RAM authorization

    The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

    • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

    • API: The API that you can call to perform the action.

    • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

    • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

      • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

      • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

    • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

    • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    ens:DescribeLoadBalancerHTTPSListenerAttribute

    get

    *All Resource

    *

    		 None None

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    ListenerPort

    integer

    Yes

    Sorgulamak istediğiniz dinleme bağlantı noktası. Geçerli değerler: 1 ile 65535 arası.

    443
    LoadBalancerId

    string

    Yes

    ELB örneğinin kimliği.

    lb-5qoxu2rsr0ytanpn4r3i****

    Response elements

    Element

    Type

    Description

    Example

    object

    Yanıt şeması.

    RequestId

    string

    İsteğin kimliği.

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

    integer

    ELB örneği tarafından kullanılan ön uç bağlantı noktası. Geçerli değerler: 1 ile 65535 arası.

    8080
    Status

    string

    Dinleyicinin durumu. Geçerli değerler:

    • Running

    • Stopped

    • Starting

    • Configuring

    • Stopping

    Running
    Bandwidth

    integer

    Edge Load Balancer (ELB) için en yüksek bant genişliği. Varsayılan değer -1'dir ve bu değer bant genişliğinin sınırlı olmadığını gösterir.

    50
    Scheduler

    string

    Yönlendirme algoritması. Geçerli değerler:

    • wrr: Daha yüksek ağırlığa sahip arka uç sunucuları, daha düşük ağırlığa sahip olanlara göre daha fazla istek alır.

    • wlc: İstekler, her bir arka uç sunucusunun ağırlığına ve yüküne göre dağıtılır. Yük, bir arka uç sunucusuna yapılan bağlantı sayısını ifade eder. İki arka uç sunucusu aynı ağırlığa sahipse, daha az bağlantısı olan arka uç sunucusu daha fazla istek alır.

    • rr: İstekler arka uç sunucularına sırayla dağıtılır.

    • sch: Kaynak IP adreslarına dayalı tutarlı karma. Aynı kaynak IP adresinden gelen istekler aynı arka uç sunucusuna dağıtılır.

    • qch: QUIC bağlantı kimliklerine dayalı tutarlı karma. Aynı QUIC bağlantı kimliğini içeren istekler aynı arka uç sunucusuna dağıtılır.

    • iqch: iQUIC CID'lerinin belirli üç baytına dayalı tutarlı karma. İkinci ile dördüncü baytları aynı olan istekler aynı arka uç sunucusuna dağıtılır.

    wrr
    HealthCheck

    string

    Durum kontrolü özelliğinin etkin olup olmadığını gösterir. Geçerli değerler:

    • on

    • off

    on
    HealthyThreshold

    integer

    Sağlıksız ve erişilemez durumdaki bir arka uç sunucusunun sağlıklı ve erişilebilir olarak ilan edilmeden önce gerçekleşmesi gereken ardışık başarılı durum kontrolü sayısı. Geçerli değerler: 2 ile 10 arası.

    Not

    Bu parametre yalnızca HealthCheck parametresi on olarak ayarlandığında döndürülür.

    3
    UnhealthyThreshold

    integer

    Sağlıklı ve erişilebilir durumdaki bir arka uç sunucusunun sağlıksız ve erişilemez olarak ilan edilmeden önce gerçekleşmesi gereken ardışık başarısız durum kontrolü sayısı. Geçerli değerler: 2 ile 10 arası.

    Not

    Bu parametre yalnızca HealthCheck parametresi on olarak ayarlandığında döndürülür.

    3
    HealthCheckTimeout

    integer

    Durum kontrolü yanıtının zaman aşımı süresi. Bir arka uç sunucusu belirtilen zaman aşımı süresi içinde yanıt vermezse, sunucu durum kontrolünden başarısız olur.

    • Varsayılan değer: 5.

    • Geçerli değerler: 1 ile 300 arası.

    • Birim: saniye.

    Not

    • Bu parametre yalnızca HealthCheck parametresi on olarak ayarlandığında etkili olur.

    • HealthCheckTimeout değeri HealthCheckInterval değerinden küçükse, HealthCheckTimeout tarafından belirtilen zaman aşımı süresi geçersiz olur ve zaman aşımı süresi olarak HealthCheckInterval değeri kullanılır.

    5
    HealthCheckConnectPort

    integer

    Durum kontrolleri için kullanılan bağlantı noktası. Geçerli değerler: 1 ile 65535 arası. Bu parametre için boş bir dize döndürülürse, durum kontrolleri için BackendServerPort tarafından belirtilen bağlantı noktası kullanılır.

    Not

    Bu parametre yalnızca HealthCheck parametresi on olarak ayarlandığında döndürülür.

    9902
    HealthCheckInterval

    integer

    Durum kontrollerinin gerçekleştirilme aralığı. Geçerli değerler: 1 ile 50 arası. Birim: saniye.

    Not

    Bu parametre yalnızca HealthCheck parametresi on olarak ayarlandığında döndürülür.

    5
    Description

    string

    Dinleyicinin açıklaması. Açıklama 1 ile 80 karakter uzunluğunda olmalıdır.

    abc
    ListenerForward

    string

    HTTP'den HTTPS'ye yönlendirmenin etkin olup olmadığını gösterir. Geçerli değerler:

    • on

    • off

    off
    ForwardPort

    integer

    HTTP isteklerini HTTPS'ye yönlendirmek için kullanılan dinleyici bağlantı noktası.

    0
    RequestTimeout

    integer

    İsteklerin zaman aşımı süresi. Varsayılan değer: 60. Geçerli değerler: 1 ile 180 arası. Birim: saniye.

    Not

    Belirtilen zaman aşımı süresi içinde arka uç sunucusundan yanıt alınamazsa, ELB istemciye HTTP 504 hata kodu döndürür.

    60
    IdleTimeout

    integer

    Boşta kalan bağlantılar için zaman aşımı süresi. Varsayılan değer: 15. Geçerli değerler: 1 ile 60 arası. Birim: saniye.

    Not

    Belirtilen zaman aşımı süresi içinde herhangi bir istek alınmazsa, ELB bağlantıyı kapatır. Başka bir istek alındığında, CLB yeni bir bağlantı kurar.

    15
    HealthCheckHttpCode

    string

    Başarılı bir durum kontrolü için HTTP durum kodu. Geçerli değerler:

    • http_2xx (varsayılan)

    • http_3xx.

    • http_4xx

    • http_5xx

    Not

    Bu parametre yalnızca HealthCheck parametresi on olarak ayarlandığında döndürülür.

    http_2xx
    HealthCheckDomain

    string

    Durum kontrolleri için kullanılan etki alanı adı.

    Not

    Bu parametre yalnızca HealthCheck parametresi on olarak ayarlandığında döndürülür.

    www.test.com
    HealthCheckURI

    string

    Durum kontrolleri için kullanılan URI. URI, 1 ile 80 karakter uzunluğunda olmalıdır.

    • URL / ile başlamalı ve / dışındaki karakterleri içermelidir.

    • Bu parametre yalnızca HealthCheck parametresi on olarak ayarlandığında döndürülür.

    /checkpreload.htm
    ServerCertificateId

    string

    Sunucu sertifikasının kimliği.

    60276**
    HealthCheckMethod

    string

    HTTP durum kontrollerinde kullanılan durum kontrolü yöntemi. Geçerli değerler:

    • head: Sayfanın head kısmını ister.

    • get: Sayfanın belirtilen kısmını ister ve varlık gövdesini döndürür.

    Not

    Bu parametre yalnızca HealthCheck parametresi on olarak ayarlandığında döndürülür.

    head
    BackendServerPort

    integer

    ELB örneğinin arka uç sunucusu tarafından kullanılan bağlantı noktası. Geçerli değerler: 1 ile 65535 arası.

    8080

    Examples

    Success response

    JSON format

    {
  "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
}

    Error codes

    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.

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.