Tüm Ürünler
Search

Bu Ürün

    :SetLoadBalancerHTTPSListenerAttribute

    Belge Merkezi

    :SetLoadBalancerHTTPSListenerAttribute

    Son Güncelleme:Sep 29, 2026

    Bir HTTPS dinleyicisinin yapılandırmalarını değiştirir.

    Operation description

    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

    slb:SetLoadBalancerHTTPSListenerAttribute

    update

    acl

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

    *certificate

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

    *loadbalancer

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

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    No

    Classic Load Balancer (CLB) örneğinin bölge kimliği.

    Bölge kimliklerini sorgulamak için DescribeRegions işlemini çağırabilirsiniz.

    cn-hangzhou
    LoadBalancerId

    string

    Yes

    Classic Load Balancer (CLB) örneğinin kimliği.

    lb-sjhfdji****
    ListenerPort

    integer

    Yes

    Classic Load Balancer (CLB) örneği tarafından kullanılan ön uç bağlantı noktası.

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

    80
    Bandwidth

    integer

    No

    Dinleyicinin en yüksek bant genişliği. Birim: Mbit/s.

    Geçerli değerler:

    • -1: En yüksek bant genişliği sınırlı değildir.

    -1
    XForwardedFor

    string

    No

    İstemcinin gerçek IP adresini almak için X-Forwarded-For başlık alanının kullanılıp kullanılmayacağını belirtir. Geçerli değerler:

    • on: evet.

    • off: hayır.

    on
    Scheduler

    string

    No

    Zamanlama algoritması. Geçerli değerler:

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

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

    wrr
    StickySession

    string

    No

    Oturum kalıcılığının etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:

    • on: evet.

    • off: hayır.

    on
    StickySessionType

    string

    No

    Çerezi işlemek için kullanılan yöntem. Geçerli değerler:

    • insert: çerez ekle.

    Bir istemci Server Load Balancer'a ilk kez eriştiğinde, Server Load Balancer yanıta bir çerez ekler (HTTP/HTTPS yanıtına SERVERID ekler). İstemci bir sonraki seferde bu çerezle bir istek gönderdiğinde, Server Load Balancer isteği daha önce kaydedilen arka uç sunucuya iletir.

    • server: çerezi yeniden yaz.

    Server Load Balancer bir kullanıcının özel bir çerez tanımladığını tespit ettiğinde, orijinal çerezi yeniden yazar. İstemci bir sonraki seferde yeni çerezle bir istek gönderdiğinde, Server Load Balancer isteği daha önce kaydedilen arka uç sunucuya iletir.

    Not

    StickySession değeri on olarak ayarlandığında bu parametre gereklidir.

    insert
    CookieTimeout

    integer

    No

    Çerezin zaman aşımı süresi.

    Geçerli değerler: 1 ile 86400 arası (saniye).

    Not

    StickySession değeri on ve StickySessionType değeri insert olarak ayarlandığında bu parametre gereklidir.

    500
    Cookie

    string

    No

    Sunucuda yapılandırılan çerez.

    Değer 1 ila 200 karakter uzunluğunda olmalı ve yalnızca ASCII harfleri ve rakamları içerebilir. Virgül (,), noktalı virgül (;) veya boşluk içeremez ve dolar işareti ($) ile başlayamaz.

    Not

    StickySession değeri on ve StickySessionType değeri server olarak ayarlandığında bu parametre gereklidir.

    testCookie
    HealthCheck

    string

    No

    Sağlık kontrollerinin etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:

    • on: evet.

    • off: hayır.

    on
    HealthCheckMethod

    string

    No

    HTTP sağlık kontrolü tarafından kullanılan sağlık kontrolü yöntemi. Geçerli değerler: head ve get.

    Not

    Bu parametre yalnızca HealthCheck değeri on olarak ayarlandığında geçerli olur.

    get
    HealthCheckDomain

    string

    No

    Sağlık kontrolleri için kullanılan etki alanı adı. Geçerli değerler:

    • $_ip: arka uç sunucunun özel IP adresi. $_ip değerini belirtirseniz veya bu parametreyi belirtmezseniz, Server Load Balancer sağlık kontrolleri için etki alanı adı olarak her bir arka uç sunucunun özel IP adresini kullanır.

    • domain: Etki alanı adı 1 ila 80 karakter uzunluğunda olmalı ve yalnızca harfler, rakamlar, noktalar (.) ve tireler (-) içerebilir.

    Not

    Bu parametre yalnızca HealthCheck değeri on olarak ayarlandığında geçerli olur.

    172.XX.XX.16
    HealthCheckURI

    string

    No

    Sağlık kontrolleri için kullanılan URI.

    Değer 1 ila 80 karakter uzunluğunda olmalı ve harfler, rakamlar, tireler (-), eğik çizgiler (/), noktalar (.), yüzde işaretleri (%), soru işaretleri (?), kare işaretleri (#) ve ve işaretleri (&) içerebilir. URI yalnızca bir eğik çizgi (/) içeremez ancak bir eğik çizgi (/) ile başlamalıdır.

    Not

    Bu parametre yalnızca HealthCheck değeri on olarak ayarlandığında geçerli olur.

    /test/index.html
    HealthyThreshold

    integer

    No

    Bir arka uç sunucunun sağlıklı olarak ilan edilmeden önce gerçekleşmesi gereken ardışık başarılı sağlık kontrolü sayısı (fail durumundan success durumuna).

    Geçerli değerler: 2 ile 10 arası.

    Not

    Bu parametre yalnızca HealthCheck değeri on olarak ayarlandığında geçerli olur.

    4
    UnhealthyThreshold

    integer

    No

    Bir arka uç sunucunun sağlıksız olarak ilan edilmeden önce gerçekleşmesi gereken ardışık başarısız sağlık kontrolü sayısı (success durumundan fail durumuna).

    Geçerli değerler: 2 ile 10 arası.

    Not

    Bu parametre yalnızca HealthCheck değeri on olarak ayarlandığında geçerli olur.

    4
    HealthCheckTimeout

    integer

    No

    Bir sağlık kontrolünden yanıt beklemek için gereken süre. Arka uç ECS örneği belirtilen süre içinde yanıt vermezse, sağlık kontrolü başarısız olur. Birim: saniye. Geçerli değerler: 1 ile 300 arası.

    Not

    Bu parametre yalnızca HealthCheck değeri on olarak ayarlandığında geçerli olur.

    3
    HealthCheckInterval

    integer

    No

    İki ardışık sağlık kontrolü arasındaki aralık. Birim: saniye.

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

    Not

    Bu parametre yalnızca HealthCheck değeri on olarak ayarlandığında geçerli olur.

    5
    HealthCheckConnectPort

    integer

    No

    Sağlık kontrolleri için kullanılan bağlantı noktası.

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

    Not

    Bu parametre yalnızca HealthCheck değeri on olarak ayarlandığında geçerli olur.

    8080
    HealthCheckHttpCode

    string

    No

    Başarılı bir sağlık kontrolünü belirten HTTP durum kodu. Birden fazla HTTP durum kodunu virgül (,) ile ayırın.

    Geçerli değerler: http_2xx, http_3xx, http_4xx ve http_5xx.

    Not

    Bu parametre yalnızca HealthCheck değeri on olarak ayarlandığında geçerli olur.

    http_2xx,http_3xx
    ServerCertificateId

    string

    No

    Sunucu sertifikasının kimliği.

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

    string

    No

    CA sertifikasının kimliği.

    • Hem bir CA sertifikası hem de bir sunucu sertifikası yüklerseniz, karşılıklı kimlik doğrulama kullanılır.

    • Yalnızca bir sunucu sertifikası yüklerseniz, tek yönlü kimlik doğrulama kullanılır.

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

    string

    No

    Bir vServer grubunun kullanılıp kullanılmayacağını belirtir. Geçerli değerler:

    • on: evet.

    • off: hayır.

    on
    VServerGroupId

    string

    No

    vServer grubunun kimliği.

    rsp-cige6j****
    XForwardedFor_SLBIP

    string

    No

    İstemci isteğinin sanal IP adresini (VIP) almak için SLB-IP başlık alanının kullanılıp kullanılmayacağını belirtir. Geçerli değerler:

    • on: evet.

    • off: hayır.

    on
    XForwardedFor_SLBID

    string

    No

    SLB örnek kimliğini almak için SLB-ID başlık alanının kullanılıp kullanılmayacağını belirtir. Geçerli değerler:

    • on: evet.

    • off: hayır.

    on
    XForwardedFor_proto

    string

    No

    SLB örneğinin dinleyici protokolünü almak için X-Forwarded-Proto başlık alanının kullanılıp kullanılmayacağını belirtir. Geçerli değerler:

    • on: evet.

    • off: hayır.

    on
    Gzip

    string

    No

    Belirli dosya türleri için Gzip sıkıştırmasının etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:

    • on: evet.

    • off: hayır.

    on
    AclId

    string

    No

    Dinleyiciye bağlı erişim kontrol listesinin (ACL) kimliği.

    AclStatus değeri on olarak ayarlandığında bu parametre gereklidir.

    acl-a2do9e413e0spzasx****
    AclType

    string

    No

    Erişim kontrolü türü. Geçerli değerler:

    • white: Yalnızca seçilen erişim kontrolü ilke grubundaki IP adreslerinden veya CIDR bloklarından gelen istekler iletilir. Beyaz listeler, hizmetinize erişmesine izin vermek istediğiniz yalnızca belirli IP adreslerini belirlemek istediğiniz senaryolar için geçerlidir. Beyaz liste etkinleştirmek bazı riskler taşır. Bir beyaz liste etkinleştirildikten sonra, SLB dinleyicisine yalnızca beyaz listedeki IP adresleri erişebilir.

    Bir beyaz liste etkinleştirilirse ancak erişim kontrolü ilke grubuna hiçbir IP adresi eklenmezse, SLB dinleyicisi tüm istekleri iletir.

    • black: Seçilen erişim kontrolü ilke grubundaki IP adreslerinden veya CIDR bloklarından gelen tüm istekler reddedilir. Kara listeler, belirli IP adreslerinden erişimi engellemek istediğiniz senaryolar için geçerlidir.

    Bir kara liste etkinleştirilirse ancak erişim kontrolü ilke grubuna hiçbir IP adresi eklenmezse, SLB dinleyicisi tüm istekleri iletir.

    Not

    Bu parametre yalnızca AclStatus değeri on olarak ayarlandığında geçerli olur.

    white
    AclStatus

    string

    No

    Erişim kontrolünün etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:

    • on: evet.

    • off: hayır.

    off
    IdleTimeout

    integer

    No

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

    Belirtilen zaman aşımı süresi boyunca hiçbir erişim isteği alınmazsa, Server Load Balancer mevcut bağlantıyı geçici olarak keser ve bir sonraki istek geldiğinde yeni bir bağlantı kurar.

    23
    RequestTimeout

    integer

    No

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

    Belirtilen zaman aşımı süresi boyunca arka uç sunucudan hiçbir yanıt alınmazsa, Server Load Balancer beklemeyi durdurur ve istemciye bir HTTP 504 hata kodu döndürür.

    223
    EnableHttp2

    string

    No

    HTTP 2.0 özelliğinin etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:

    • on: evet.

    • off: hayır.

    off
    TLSCipherPolicy

    string

    No

    HTTPS için kullanılabilen TLS protokolü sürümlerini ve desteklenen şifreleme algoritması paketlerini içeren güvenlik politikası.

    • tls_cipher_policy_1_0:

      Desteklenen TLS sürümleri: TLSv1.0, TLSv1.1 ve TLSv1.2.

      Desteklenen şifreleme algoritması paketleri: 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 ve DES-CBC3-SHA.

    • tls_cipher_policy_1_1:

      Desteklenen TLS sürümleri: TLSv1.1 ve TLSv1.2.

      Desteklenen şifreleme algoritması paketleri: 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 ve DES-CBC3-SHA.

    • tls_cipher_policy_1_2

      Desteklenen TLS sürümleri: TLSv1.2.

      Desteklenen şifreleme algoritması paketleri: 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 ve DES-CBC3-SHA.

    • tls_cipher_policy_1_2_strict

      Desteklenen TLS sürümleri: TLSv1.2.

      Desteklenen şifreleme algoritması paketleri: ECDHE-RSA-AES128-GCM-SHA256, ECDHE-RSA-AES256-GCM-SHA384, ECDHE-RSA-AES128-SHA256, ECDHE-RSA-AES256-SHA384, ECDHE-RSA-AES128-SHA ve ECDHE-RSA-AES256-SHA.

    • tls_cipher_policy_1_2_strict_with_1_3

      Desteklenen TLS sürümleri: TLSv1.2 ve TLSv1.3.

      Desteklenen şifreleme algoritması paketleri: 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 ve ECDHE-RSA-AES256-SHA.

    tls_cipher_policy_1_2
    Description

    string

    No

    Özel dinleyici adı.

    Ad 1 ila 256 karakter uzunluğunda olmalı ve Çince karakterler, harfler, rakamlar, tireler (-), eğik çizgiler (/), noktalar (.) ve alt çizgiler (_) içerebilir.

    https_80
    XForwardedFor_SLBPORT

    string

    No

    SLB örneğinin dinleyici bağlantı noktasını almak için XForwardedFor_SLBPORT başlık alanının kullanılıp kullanılmayacağını belirtir. Geçerli değerler:

    • on: evet.

    • off: hayır.

    off
    XForwardedFor_ClientSrcPort

    string

    No

    SLB örneğine erişen istemcinin bağlantı noktasını almak için XForwardedFor_ClientSrcPort başlık alanının kullanılıp kullanılmayacağını belirtir. Geçerli değerler:

    • on: evet.

    • off: hayır.

    off
    DryRun

    boolean

    No

    Response elements

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    İstek kimliği.

    CEF72CEB-54B6-4AE8-B225-F876FF7BA984

    Examples

    Success response

    JSON format

    {
  "RequestId": "CEF72CEB-54B6-4AE8-B225-F876FF7BA984"
}

    Error codes

    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.
    400 IpVersionConflict The ip version of this LoadBalancer and the Acl is conflict.
    400 InvalidParameter.IdleTimeout The specified IdleTimeout exceeds the limit.
    400 InvalidParameter.RequestTimeout The specified RequestTimeout exceeds the limit.
    400 ListenerForwardNotSupport X-Forward-For is not supported to a ipv6 instance.
    400 InvalidParameter.RegionNotSupport The region does not support the parameter: %s.
    400 InvalidParameter.SpecNotSupport The loadBalancer of shared spec does not support the parameter: %s.
    400 OperationFailed.ServerGroupInUse The VServerGroup or MasterSlaveServerGroup can not be close for this listener.
    400 InvalidParameter.VServerGroupId The MasterSlaveServerGroup can not be attached to HTTP or HTTPS listener.
    400 MissingParam.HealthCheckDomain The HealthCheckDomain is required when HealthCheckHttpVersion is http1.1.
    400 InvalidParameter.HealthCheckHttpVersion The param HealthCheckHttpVersion is invalid.
    400 Duplicated.AclEntry %s.
    400 CertificateNotExist The specified CertificateId does not exist.
    400 InvalidTLSPolicyId.NotExist The specified TLS cipher policy does not exist.
    400 TLSPolicyConfiguring The specified TLS cipher policy is configuring.
    400 TLSCipherPolicyVipRelationOverLimit The number of listeners associated with a policy has exceeded.
    400 TooManyCertificates The number of certificates must not be greater than one.
    400 CertificateTypeMismatched The certificate type does not match.
    400 MissingParam.ServerCertificates Server certificates are required.
    400 CnCertificateNotSupport The cn certificate is not support.
    400 InvalidParam.CertificateBindingType The param CertificateBindingType is invalid.
    400 InvalidParamSize.ServerCertificates The size of param ServerCertificates is invalid.
    400 TooManyCertificates.ServerCertificates The number of certificates must not be greater than one.
    400 AclListenerOverLimit This acl has reached the limit of binding to listeners.
    400 QuotaLimitExceeds.AclAttachedToListener The number of Acl bound listeners has reached the quota limit
    400 QuotaLimitExceeds.TotalAclEntry The number of Acl entries has reached the quota limit.
    400 QuotaLimitExceeds.AclListenerOverLimit This acl has reached the limit of binding to listeners.
    400 DryRunOperation Request validation has been passed with DryRun flag set.
    404 ResourceNotFound.Certificate The specified resource is not found.

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.