Todos los productos
Search
Centro de documentos

Server Load Balancer:SetLoadBalancerHTTPSListenerAttribute

Última actualización: Sep 08, 2026

Modifica las configuraciones de un listener HTTPS.

Descripción de la operación

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

  • Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.

  • API: La API que debe invocarse para llevar a cabo la acción.

  • Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.

  • Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.

    • En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.

    • Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.

  • Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.

  • Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

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
Ninguna

Parámetros de la solicitud

Parámetro

Tipo

Obligatorio

Descripción

Ejemplo

RegionId

string

No

El ID de la región de la instancia de Classic Load Balancer (CLB).

Puede llamar a la operación DescribeRegions para consultar los ID de región.

cn-hangzhou

LoadBalancerId

string

Sí

El ID de la instancia de Classic Load Balancer (CLB).

lb-sjhfdji****

ListenerPort

integer

Sí

El puerto frontend que utiliza la instancia de Classic Load Balancer (CLB).

Valores válidos: 1 a 65535.

80

Bandwidth

integer

No

El ancho de banda máximo del listener. Unidad: Mbit/s.

Valores válidos:

  • -1: El ancho de banda máximo no está limitado.

-1

XForwardedFor

string

No

Especifica si se debe utilizar el campo de encabezado X-Forwarded-For para obtener la dirección IP real del cliente. Valores válidos:

  • on: sí.

  • off: no.

on

Scheduler

string

No

El algoritmo de programación. Valores válidos:

  • wrr: Los servidores backend con mayores pesos reciben más solicitudes que los servidores backend con menores pesos.

  • rr: Las solicitudes se distribuyen a los servidores backend en secuencia.

wrr

StickySession

string

No

Especifica si se debe habilitar la persistencia de sesión. Valores válidos:

  • on: sí.

  • off: no.

on

StickySessionType

string

No

El método utilizado para gestionar la cookie. Valores válidos:

  • insert: insertar cookie.

Cuando un cliente accede a Server Load Balancer por primera vez, Server Load Balancer inserta una cookie en la respuesta (inserta SERVERID en la respuesta HTTP/HTTPS). La próxima vez que el cliente envíe una solicitud con esta cookie, Server Load Balancer reenviará la solicitud al servidor backend que se registró previamente.

  • server: reescribir cookie.

Cuando Server Load Balancer detecta que un usuario ha definido una cookie personalizada, reescribe la cookie original. La próxima vez que el cliente envíe una solicitud con la nueva cookie, Server Load Balancer reenviará la solicitud al servidor backend que se registró previamente.

Nota

Este parámetro es obligatorio cuando StickySession se establece en on.

insert

CookieTimeout

integer

No

El periodo de tiempo de espera de la cookie.

Valores válidos: 1 a 86400 (segundos).

Nota

Este parámetro es obligatorio cuando StickySession se establece en on y StickySessionType se establece en insert.

500

Cookie

string

No

La cookie configurada en el servidor.

El valor debe tener una longitud de 1 a 200 caracteres y solo puede contener letras ASCII y dígitos. No puede contener comas (,), punto y coma (;) ni espacios, y no puede comenzar con un signo de dólar ($).

Nota

Este parámetro es obligatorio cuando StickySession se establece en on y StickySessionType se establece en server.

testCookie

HealthCheck

string

No

Especifica si se deben habilitar las comprobaciones de estado. Valores válidos:

  • on: sí.

  • off: no.

on

HealthCheckMethod

string

No

El método de comprobación de estado utilizado por la comprobación de estado HTTP. Valores válidos: head y get.

Nota

Este parámetro solo surte efecto cuando HealthCheck se establece en on.

get

HealthCheckDomain

string

No

El nombre de dominio utilizado para las comprobaciones de estado. Valores válidos:

  • $_ip: la dirección IP privada del servidor backend. Si especifica $_ip o no especifica este parámetro, Server Load Balancer utiliza la dirección IP privada de cada servidor backend como nombre de dominio para las comprobaciones de estado.

  • domain: El nombre de dominio debe tener una longitud de 1 a 80 caracteres y solo puede contener letras, dígitos, puntos (.) y guiones (-).

Nota

Este parámetro solo surte efecto cuando HealthCheck se establece en on.

172.XX.XX.16

HealthCheckURI

string

No

El URI utilizado para las comprobaciones de estado.

El valor debe tener una longitud de 1 a 80 caracteres y puede contener letras, dígitos, guiones (-), barras diagonales (/), puntos (.), signos de porcentaje (%), signos de interrogación (?), signos de número (#) y ampersands (&). El URI no puede contener solo una barra diagonal (/), pero debe comenzar con una barra diagonal (/).

Nota

Este parámetro solo surte efecto cuando HealthCheck se establece en on.

/test/index.html

HealthyThreshold

integer

No

El número de comprobaciones de estado exitosas consecutivas que deben producirse antes de que un servidor backend se declare en buen estado (de fail a success).

Valores válidos: 2 a 10.

Nota

Este parámetro solo surte efecto cuando HealthCheck se establece en on.

4

UnhealthyThreshold

integer

No

El número de comprobaciones de estado fallidas consecutivas que deben producirse antes de que un servidor backend se declare en mal estado (de success a fail).

Valores válidos: 2 a 10.

Nota

Este parámetro solo surte efecto cuando HealthCheck se establece en on.

4

HealthCheckTimeout

integer

No

La cantidad de tiempo de espera para recibir una respuesta de una comprobación de estado. Si la instancia ECS backend no responde dentro del tiempo especificado, la comprobación de estado falla. Unidad: segundos. Valores válidos: 1 a 300.

Nota

Este parámetro solo surte efecto cuando HealthCheck se establece en on.

3

HealthCheckInterval

integer

No

El intervalo entre dos comprobaciones de estado consecutivas. Unidad: segundos.

Valores válidos: 1 a 50.

Nota

Este parámetro solo surte efecto cuando HealthCheck se establece en on.

5

HealthCheckConnectPort

integer

No

El puerto utilizado para las comprobaciones de estado.

Valores válidos: 1 a 65535.

Nota

Este parámetro solo surte efecto cuando HealthCheck se establece en on.

8080

HealthCheckHttpCode

string

No

El código de estado HTTP que indica una comprobación de estado exitosa. Separe varios códigos de estado HTTP con comas (,).

Valores válidos: http_2xx, http_3xx, http_4xx y http_5xx.

Nota

Este parámetro solo surte efecto cuando HealthCheck se establece en on.

http_2xx,http_3xx

ServerCertificateId

string

No

El ID del certificado de servidor.

idkp-123-cn-te****

CACertificateId

string

No

El ID del certificado de CA.

  • Si carga tanto un certificado de CA como un certificado de servidor, se utiliza la autenticación mutua.

  • Si solo carga un certificado de servidor, se utiliza la autenticación unidireccional.

139a00604ad-cn-east-****

VServerGroup

string

No

Especifica si se debe utilizar un grupo vServer. Valores válidos:

  • on: sí.

  • off: no.

on

VServerGroupId

string

No

El ID del grupo vServer.

rsp-cige6j****

XForwardedFor_SLBIP

string

No

Especifica si se debe utilizar el campo de encabezado SLB-IP para obtener la dirección IP virtual (VIP) de la solicitud del cliente. Valores válidos:

  • on: sí.

  • off: no.

on

XForwardedFor_SLBID

string

No

Especifica si se debe utilizar el campo de encabezado SLB-ID para obtener el ID de la instancia SLB. Valores válidos:

  • on: sí.

  • off: no.

on

XForwardedFor_proto

string

No

Especifica si se debe utilizar el campo de encabezado X-Forwarded-Proto para obtener el protocolo del listener de la instancia SLB. Valores válidos:

  • on: sí.

  • off: no.

on

Gzip

string

No

Especifica si se debe habilitar la compresión Gzip para tipos de archivos específicos. Valores válidos:

  • on: sí.

  • off: no.

on

AclId

string

No

El ID de la lista de control de acceso (ACL) vinculada al listener.

Este parámetro es obligatorio cuando AclStatus se establece en on.

acl-a2do9e413e0spzasx****

AclType

string

No

El tipo de control de acceso. Valores válidos:

  • white: Solo se reenvían las solicitudes de las direcciones IP o bloques CIDR en el grupo de políticas de control de acceso seleccionado. Las listas blancas se aplican a escenarios en los que desea permitir que solo direcciones IP específicas accedan a su servicio. Habilitar una lista blanca conlleva algunos riesgos. Después de habilitar una lista blanca, solo las direcciones IP en la lista blanca pueden acceder al listener SLB.

Si se habilita una lista blanca pero no se agrega ninguna dirección IP al grupo de políticas de control de acceso, el listener SLB reenvía todas las solicitudes.

  • black: Se rechazan todas las solicitudes de las direcciones IP o bloques CIDR en el grupo de políticas de control de acceso seleccionado. Las listas negras se aplican a escenarios en los que desea bloquear el acceso desde direcciones IP específicas.

Si se habilita una lista negra pero no se agrega ninguna dirección IP al grupo de políticas de control de acceso, el listener SLB reenvía todas las solicitudes.

Nota

Este parámetro solo surte efecto cuando AclStatus se establece en on.

white

AclStatus

string

No

Especifica si se debe habilitar el control de acceso. Valores válidos:

  • on: sí.

  • off: no.

off

IdleTimeout

integer

No

El periodo de tiempo de espera de conexión inactiva. Valores válidos: 1 a 60. Unidad: segundos. Valor predeterminado: 15.

Si no se recibe ninguna solicitud de acceso durante el periodo de tiempo de espera especificado, Server Load Balancer interrumpe temporalmente la conexión actual y restablece una nueva conexión cuando llega la siguiente solicitud.

23

RequestTimeout

integer

No

El periodo de tiempo de espera de la solicitud. Valores válidos: 1 a 180. Unidad: segundos. Valor predeterminado: 60.

Si no se recibe ninguna respuesta del servidor backend durante el periodo de tiempo de espera especificado, Server Load Balancer deja de esperar y devuelve un código de error HTTP 504 al cliente.

223

EnableHttp2

string

No

Especifica si se debe habilitar la función HTTP 2.0. Valores válidos:

  • on: sí.

  • off: no.

off

TLSCipherPolicy

string

No

La política de seguridad que contiene las versiones del protocolo TLS y los conjuntos de algoritmos de cifrado compatibles disponibles para HTTPS.

  • tls_cipher_policy_1_0:

    Versiones de TLS compatibles: TLSv1.0, TLSv1.1 y TLSv1.2.

    Conjuntos de algoritmos de cifrado compatibles: 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 y DES-CBC3-SHA.

  • tls_cipher_policy_1_1:

    Versiones de TLS compatibles: TLSv1.1 y TLSv1.2.

    Conjuntos de algoritmos de cifrado compatibles: 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 y DES-CBC3-SHA.

  • tls_cipher_policy_1_2

    Versiones de TLS compatibles: TLSv1.2.

    Conjuntos de algoritmos de cifrado compatibles: 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 y DES-CBC3-SHA.

  • tls_cipher_policy_1_2_strict

    Versiones de TLS compatibles: TLSv1.2.

    Conjuntos de algoritmos de cifrado compatibles: ECDHE-RSA-AES128-GCM-SHA256, ECDHE-RSA-AES256-GCM-SHA384, ECDHE-RSA-AES128-SHA256, ECDHE-RSA-AES256-SHA384, ECDHE-RSA-AES128-SHA y ECDHE-RSA-AES256-SHA.

  • tls_cipher_policy_1_2_strict_with_1_3

    Versiones de TLS compatibles: TLSv1.2 y TLSv1.3.

    Conjuntos de algoritmos de cifrado compatibles: 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 y ECDHE-RSA-AES256-SHA.

tls_cipher_policy_1_2

Description

string

No

El nombre personalizado del listener.

El nombre debe tener una longitud de 1 a 256 caracteres y puede contener caracteres chinos, letras, dígitos, guiones (-), barras diagonales (/), puntos (.) y guiones bajos (_).

https_80

XForwardedFor_SLBPORT

string

No

Especifica si se debe utilizar el campo de encabezado XForwardedFor_SLBPORT para obtener el puerto del listener de la instancia SLB. Valores válidos:

  • on: sí.

  • off: no.

off

XForwardedFor_ClientSrcPort

string

No

Especifica si se debe utilizar el campo de encabezado XForwardedFor_ClientSrcPort para obtener el puerto del cliente que accede a la instancia SLB. Valores válidos:

  • on: sí.

  • off: no.

off

DryRun

boolean

No

Elementos de la respuesta

Elemento

Tipo

Descripción

Ejemplo

object

RequestId

string

El ID de la solicitud.

CEF72CEB-54B6-4AE8-B225-F876FF7BA984

Ejemplos

Respuesta exitosa

JSON Formato

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

Códigos de error

Código de estado HTTP

Código de error

Mensaje de error

Descripción

400 ParamDuplicateError The specified parameter value of XForwardedFor_ClientCertSubjectDNAlias is duplicate. Please change to a different one. El parámetro XForwardedFor_ClientCertClientVerifyAlias está duplicado.
400 IpVersionConflict The ip version of this LoadBalancer and the Acl is conflict. La versión de IP de la instancia de Server Load Balancer especificada entra en conflicto con el tipo de IP que admite la ACL.
400 InvalidParameter.IdleTimeout The specified IdleTimeout exceeds the limit. El IdleTimeout especificado no es válido. Verifique las restricciones del parámetro y vuelva a intentarlo después de corregirlo.
400 InvalidParameter.RequestTimeout The specified RequestTimeout exceeds the limit. El RequestTimeout especificado no es válido. Verifique las restricciones del parámetro y vuelva a intentarlo.
400 ListenerForwardNotSupport X-Forward-For is not supported to a ipv6 instance. Las instancias de SLB IPv6 no admiten X-Forwarded-For.
400 InvalidParameter.RegionNotSupport The region does not support the parameter: %s. El parámetro especificado no se admite en la región actual.
400 InvalidParameter.SpecNotSupport The loadBalancer of shared spec does not support the parameter: %s. El parámetro especificado no es compatible con las instancias de SLB de recursos compartidos.
400 OperationFailed.ServerGroupInUse The VServerGroup or MasterSlaveServerGroup can not be close for this listener. La operación falló porque el listener actual no admite deshabilitar el grupo de servidores.
400 InvalidParameter.VServerGroupId The MasterSlaveServerGroup can not be attached to HTTP or HTTPS listener. Los listeners HTTP o HTTPS no admiten grupos de servidores principales/secundarios.
400 MissingParam.HealthCheckDomain The HealthCheckDomain is required when HealthCheckHttpVersion is http1.1. Falta el parámetro HealthCheckDomain.
400 InvalidParameter.HealthCheckHttpVersion The param HealthCheckHttpVersion is invalid. El HealthCheckHttpVersion especificado no es válido. Verifique las restricciones del parámetro y vuelva a intentarlo después de corregirlo.
400 Duplicated.AclEntry %s. %s
400 CertificateNotExist The specified CertificateId does not exist. El certificado especificado no existe.
400 InvalidTLSPolicyId.NotExist The specified TLS cipher policy does not exist. La política de seguridad TLS especificada no existe.
400 TLSPolicyConfiguring The specified TLS cipher policy is configuring. La TLSCipherPolicy especificada se está modificando.
400 TLSCipherPolicyVipRelationOverLimit The number of listeners associated with a policy has exceeded. El número de instancias de TLSCipherPolicy asociadas al listener alcanzó el límite de la cuota.
400 TooManyCertificates The number of certificates must not be greater than one. El número de certificados no puede ser superior a 1.
400 CertificateTypeMismatched The certificate type does not match. El tipo del certificado especificado no coincide.
400 MissingParam.ServerCertificates Server certificates are required. Falta el parámetro ServerCertificates.
400 CnCertificateNotSupport The cn certificate is not support. No se admiten los certificados de China National Cryptographic Algorithm (SM).
400 InvalidParam.CertificateBindingType The param CertificateBindingType is invalid. El CertificateBindingType especificado no es válido. Verifique las restricciones del parámetro e inténtelo de nuevo después de modificarlo.
400 InvalidParamSize.ServerCertificates The size of param ServerCertificates is invalid. La longitud del ServerCertificates especificado no es válida. Verifique las restricciones del parámetro y vuelva a intentarlo.
400 TooManyCertificates.ServerCertificates The number of certificates must not be greater than one. El número de certificados no puede ser superior a 1.
400 AclListenerOverLimit This acl has reached the limit of binding to listeners. El número de listeners que se pueden asociar con la ACL especificada ha alcanzado el límite de cuota.
400 QuotaLimitExceeds.AclAttachedToListener The number of Acl bound listeners has reached the quota limit El número de listeners asociados a la ACL ha alcanzado el límite de la cuota.
400 QuotaLimitExceeds.TotalAclEntry The number of Acl entries has reached the quota limit. El número de entradas de ACL ha alcanzado el límite de la cuota.
400 QuotaLimitExceeds.AclListenerOverLimit This acl has reached the limit of binding to listeners. El número de listeners que se pueden asociar con la ACL especificada ha alcanzado el límite de cuota.
400 DryRunOperation Request validation has been passed with DryRun flag set. La solicitud DryRun superó la validación.
404 ResourceNotFound.Certificate The specified resource is not found.

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.