Tüm Ürünler
Search

Bu Ürün

    :CreateLoadBalancerHTTPSListener

    Belge Merkezi

    :CreateLoadBalancerHTTPSListener

    Son Güncelleme:Sep 29, 2026

    Bir HTTPS dinleyicisi oluşturur.

    Operation description

    Dikkat edilecek hususlar

    Yeni oluşturulan bir dinleyici durduruldu durumundadır. Bir dinleyici oluşturduktan sonra, trafiği iletmek üzere dinleyiciyi başlatmak için StartLoadBalancerListener işlemini çağırın.

    Başlamadan önce

    Bir Klasik Yük Dengeleyici (CLB) örneği oluşturulmuştur. Daha fazla bilgi için CreateLoadBalancer konusuna bakın.

    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:CreateLoadBalancerHTTPSListener

    create

    *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

    CLB örneğinin bölge kimliği.

    Bölge kimliğini Bölgeler ve alanlar listesinden veya DescribeRegions işlemini çağırarak sorgulayabilirsiniz.

    cn-hangzhou
    LoadBalancerId

    string

    Yes

    CLB örneğinin kimliği.

    lb-bp1o94dp5i6earr****
    Bandwidth

    integer

    Yes

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

    Geçerli değerler:

    • -1: Trafiğe göre ödeme yapan internete açık bir SLB örneği için en yüksek bant genişliğini -1 olarak ayarlayabilirsiniz; bu, sınırsız bant genişliğini belirtir.

    -1
    ListenerPort

    integer

    Yes

    Örnek tarafından kullanılan ön uç bağlantı noktası.

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

    80
    BackendServerPort

    integer

    No

    Örnek tarafından kullanılan arka uç bağlantı noktası. Geçerli değerler: 1 ile 65535 arası.

    Bir vServer grubu kullanmıyorsanız (VServerGroupId belirtilmemişse) bu parametre gereklidir.

    80
    Tag

    array<object>

    No

    Etiketler.

    object

    No

    Etiketler.

    Key

    string

    No

    Dinleyicinin etiket anahtarı. N için geçerli değerler: 1 ile 20 arası. Etiket anahtarı boş bir dize olamaz. Etiket anahtarı en fazla 64 karakter uzunluğunda olabilir ve aliyun veya acs: ile başlayamaz. Etiket anahtarı http:// veya https:// içeremez.

    TestKey
    Value

    string

    No

    Dinleyicinin etiket değeri. N için geçerli değerler: 1 ile 20 arası. Etiket değeri boş bir dize olabilir. Etiket değeri en fazla 128 karakter uzunluğunda olabilir ve acs: ile başlayamaz. Etiket değeri http:// veya https:// içeremez.

    TestValue
    XForwardedFor

    string

    No

    İstemci IP adresini almak için X-Forwarded-For başlığı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ç sunucularına göre daha fazla istek alır.

    • rr: İstekler arka uç sunucularına 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

    Çerezleri işlemek için kullanılan yöntem. Geçerli değerler: insert ve server.

    • insert: çerez ekle.

    Bir istemci Server Load Balancer örneğine ilk kez eriştiğinde, Server Load Balancer örneği 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 örneği isteği daha önce kaydedilen arka uç sunucusuna iletir.

    • server: çerezi yeniden yaz.

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

    Not

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

    insert

    CookieTimeout

    integer

    No

    Çerezin zaman aşımı süresi. Birim: saniye.

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

    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.

    Çerez 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. 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

    Yes

    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ç sunucusunun özel IP adresi. $_ip değerini belirtirseniz veya bu parametreyi belirtmezseniz, Server Load Balancer örneği sağlık kontrolleri için etki alanı adı olarak her arka uç sunucusunun ö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.

    URI 1 ila 80 karakter uzunluğunda olmalı ve harfler, rakamlar ve şu özel karakterleri içerebilir: -/.%?#&. URI yalnızca / olamaz ancak / 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ç sunucusunun 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çiş).

    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ç sunucusunun 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çiş).

    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 ayrılan 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
    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
    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
    HealthCheckHttpCode

    string

    No

    Başarılı bir sağlık kontrolünü belirten HTTP durum kodu. Birden fazla durum kodunu virgülle (,) 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-test-****
    VServerGroupId

    string

    No

    vServer grubunun kimliği.

    rsp-cige6j5e7p****
    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-hangzh****
    XForwardedFor_SLBIP

    string

    No

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

    • on: evet.

    • off: hayır.

    on
    XForwardedFor_SLBID

    string

    No

    SLB örneğinin örnek kimliğini almak için SLB-ID başlığı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ığı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.

    Not

    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 yalnızca belirli IP adreslerinin erişmesine izin vermek istediğiniz senaryolar için geçerlidir. Beyaz liste ayarlamak risk oluşturur. Bir beyaz listeyi etkinleştirdikten sonra, SLB dinleyicisine yalnızca beyaz listedeki IP adresleri erişebilir.

    Bir beyaz liste etkinleştirilir 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 istekler iletilmez. Kara listeler, belirli IP adreslerinden gelen erişimi engellemek istediğiniz senaryolar için geçerlidir.

    Bir kara liste etkinleştirilir 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
    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_443
    IdleTimeout

    integer

    No

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

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

    12
    RequestTimeout

    integer

    No

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

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

    23
    EnableHttp2

    string

    No

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

    • on: evet.

    • off: hayır.

    off
    TLSCipherPolicy

    string

    No

    HTTPS için desteklenen TLS protokolü sürümlerini ve ş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_1
    XForwardedFor_SLBPORT

    string

    No

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

    • on: evet.

    • off: hayır.

    off
    XForwardedFor_ClientSrcPort

    string

    No

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

    • on: evet.

    • off: hayır.

    off

    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 ListenerProcessing A previous configuration of the listener is pending,please try again later.
    400 Certkey.Forbidden The specified certkey is not owned by the current user.
    400 InvalidParameter.ListenerPortConflict There is conflict listener port exists.
    400 ResourceNotAvailible.HttpsListener The specified Zone did not have enough resource.
    400 AclNotExist Acl does not exist.
    400 OperationUnsupported.CreateLoadBalancerLayer7Listener The slb instance does not support create HTTP or HTTPS 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 OperationFailed.InsufficientResources The loadbalancer does not support this operation because of insufficient resources.
    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 CertificateTypeMismatched The certificate type does not match.
    400 MissingParam.ServerCertificates Server certificates are required.
    400 TooManyCertificates The number of certificates must not be greater than one.
    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 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.
    400 LbSupportTcpsslOnly The specified load balancer supports TCP SSL type listener only.
    400 ListenerNotSupportRule You cannot create a rule for the specified listener.
    400 Mismatch.SlbSpecTypeAndListenerProtocol The SlbSpecType and ListenerProtocol are mismatched.
    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.
    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.
    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.