CreateLoadBalancerHTTPSListener - Server Load Balancer - Centro de documentación de Alibaba Cloud

Crea un listener HTTPS.

Descripción de la operación

Precauciones

Un listener recién creado se encuentra en estado stopped. Después de crear un listener, invoque la operación StartLoadBalancerListener para iniciar el listener y reenviar el tráfico.

Antes de comenzar

Se ha creado una instancia de Classic Load Balancer (CLB). Para obtener más información, consulte CreateLoadBalancer.

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

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 CLB. Puede consultar el ID de la región en la lista de Regiones y zonas o invocando la operación DescribeRegions.	cn-hangzhou
LoadBalancerId	string	Sí	El ID de la instancia de CLB.	lb-bp1o94dp5i6earr****
Bandwidth	integer	Sí	El ancho de banda máximo del listener. Unidad: Mbit/s. Valores válidos: -1: Para una instancia de SLB orientada a Internet con pago por tráfico, puede establecer el ancho de banda máximo en -1, lo que indica un ancho de banda ilimitado.	-1
ListenerPort	integer	Sí	El puerto frontend que utiliza la instancia. Valores válidos: 1 a 65535.	80
BackendServerPort	integer	No	El puerto backend que utiliza la instancia. Valores válidos: 1 a 65535. Este parámetro es obligatorio si no utiliza un grupo de vServer (no se especifica VServerGroupId).	80
Tag	array<object>	No	Las etiquetas.
	object	No	Las etiquetas.
Key	string	No	La clave de etiqueta del listener. Valores válidos de N: 1 a 20. La clave de etiqueta no puede ser una cadena vacía. La clave de etiqueta puede tener hasta 64 caracteres de longitud y no puede comenzar con `aliyun` ni `acs:`. La clave de etiqueta no puede contener `http://` ni `https://`.	TestKey
Value	string	No	El valor de etiqueta del listener. Valores válidos de N: 1 a 20. El valor de etiqueta puede ser una cadena vacía. El valor de etiqueta puede tener hasta 128 caracteres de longitud y no puede comenzar con `acs:`. El valor de etiqueta no puede contener `http://` ni `https://`.	TestValue
XForwardedFor	string	No	Especifica si se debe utilizar el encabezado `X-Forwarded-For` para obtener la dirección IP 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 pesos más altos reciben más solicitudes que los servidores backend con pesos más bajos. 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 las cookies. Valores válidos: insert y server. insert: insertar cookie. Cuando un cliente accede a la instancia de Server Load Balancer por primera vez, la instancia de 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, la instancia de Server Load Balancer reenviará la solicitud al servidor backend que se registró previamente. server: reescribir cookie. Cuando la instancia de Server Load Balancer detecta una cookie definida por el usuario, reescribe la cookie original. La próxima vez que el cliente envíe una solicitud con la nueva cookie, la instancia de 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. Unidad: segundos. Valores válidos: 1 a 86400. 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. La cookie debe tener de 1 a 200 caracteres de longitud y solo puede contener letras ASCII y dígitos. No puede contener comas (,), punto y coma (;) ni espacios. 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	Sí	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, la instancia de 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 de 1 a 80 caracteres de longitud 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	La URI utilizada para las comprobaciones de estado. La URI debe tener de 1 a 80 caracteres de longitud y puede contener letras, dígitos y los siguientes caracteres especiales: `-/.%?#&`. La URI no puede ser solo `/`, sino que debe comenzar con `/`. 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 de 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
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
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
HealthCheckHttpCode	string	No	El código de estado HTTP que indica una comprobación de estado exitosa. Separe varios códigos de estado 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-test-****
VServerGroupId	string	No	El ID del grupo de vServer.	rsp-cige6j5e7p****
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-hangzh****
XForwardedFor_SLBIP	string	No	Especifica si se debe utilizar el encabezado `SLB-IP` para obtener la dirección IP virtual (VIP) del cliente. Valores válidos: on: sí. off: no.	on
XForwardedFor_SLBID	string	No	Especifica si se debe utilizar el encabezado `SLB-ID` para obtener el ID de la instancia de SLB. Valores válidos: on: sí. off: no.	on
XForwardedFor_proto	string	No	Especifica si se debe utilizar el encabezado `X-Forwarded-Proto` para obtener el protocolo del listener de la instancia de SLB. Valores válidos: on: sí. off: no.	on
Gzip	string	No	Especifica si se debe habilitar la compresión `Gzip` para tipos de archivo 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. Nota 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 son aplicables a escenarios en los que desea permitir que solo direcciones IP específicas accedan a su servicio. Configurar una lista blanca conlleva riesgos. Después de habilitar una lista blanca, solo las direcciones IP en la lista blanca pueden acceder al listener de 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 de SLB reenvía todas las solicitudes. black: No 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 negras son aplicables 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 de 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
Description	string	No	El nombre personalizado del listener. El nombre debe tener de 1 a 256 caracteres de longitud y puede contener caracteres chinos, letras, dígitos, guiones (-), barras diagonales (/), puntos (.) y guiones bajos (_).	HTTPS_443
IdleTimeout	integer	No	El periodo de tiempo de espera de conexión inactiva. Valores válidos: 1 a 60. Valor predeterminado: 15. Unidad: segundos. Si no se recibe ninguna solicitud de acceso dentro del periodo de tiempo de espera especificado, la instancia de Server Load Balancer interrumpe temporalmente la conexión actual y restablece una nueva conexión cuando llega la siguiente solicitud.	12
RequestTimeout	integer	No	El periodo de tiempo de espera de la solicitud. Valores válidos: 1 a 180. Valor predeterminado: 60. Unidad: segundos. Si no se recibe ninguna respuesta del servidor backend dentro del periodo de tiempo de espera especificado, la instancia de Server Load Balancer deja de esperar y devuelve un código de error HTTP 504 al cliente.	23
EnableHttp2	string	No	Especifica si se debe habilitar la función HTTP/2. Valores válidos: on: sí. off: no.	off
TLSCipherPolicy	string	No	La política de seguridad que contiene las versiones de protocolo TLS admitidas y los conjuntos de algoritmos de cifrado para HTTPS. tls_cipher_policy_1_0: Versiones de TLS admitidas: TLSv1.0, TLSv1.1 y TLSv1.2. Conjuntos de algoritmos de cifrado admitidos: 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 admitidas: TLSv1.1 y TLSv1.2. Conjuntos de algoritmos de cifrado admitidos: 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 admitidas: TLSv1.2. Conjuntos de algoritmos de cifrado admitidos: 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 admitidas: TLSv1.2. Conjuntos de algoritmos de cifrado admitidos: 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 admitidas: TLSv1.2 y TLSv1.3. Conjuntos de algoritmos de cifrado admitidos: 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_1
XForwardedFor_SLBPORT	string	No	Especifica si se debe utilizar el encabezado `XForwardedFor_SLBPORT` para obtener el puerto del listener de la instancia de Server Load Balancer. Valores válidos: on: sí. off: no.	off
XForwardedFor_ClientSrcPort	string	No	Especifica si se debe utilizar el encabezado `XForwardedFor_ClientSrcPort` para obtener el puerto del cliente que accede a la instancia de Server Load Balancer. Valores válidos: on: sí. off: no.	off

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	ListenerProcessing	A previous configuration of the listener is pending,please try again later.	El listener actual se está configurando. Inténtelo de nuevo más tarde.
400	Certkey.Forbidden	The specified certkey is not owned by the current user.	El certificado y la clave especificados no pertenecen al usuario actual.
400	InvalidParameter.ListenerPortConflict	There is conflict listener port exists.	El puerto de escucha especificado ya existe.
400	ResourceNotAvailible.HttpsListener	The specified Zone did not have enough resource.	No hay recursos suficientes en la zona especificada.
400	AclNotExist	Acl does not exist.	La ACL especificada no existe.
400	OperationUnsupported.CreateLoadBalancerLayer7Listener	The slb instance does not support create HTTP or HTTPS listener.	La instancia de SLB actual no admite crear listeners HTTP o HTTPS.
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	OperationFailed.InsufficientResources	The loadbalancer does not support this operation because of insufficient resources.	La operación falló porque la instancia de Server Load Balancer no admite esta operación debido a recursos insuficientes.
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	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	TooManyCertificates	The number of certificates must not be greater than one.	El número de certificados no puede ser superior a 1.
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	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.	La instancia especificada no admite crear listeners de tipo TCP/SSL.
400	LbSupportTcpsslOnly	The specified load balancer supports TCP SSL type listener only.	La instancia especificada solo admite crear listeners de tipo TCP/SSL.
400	ListenerNotSupportRule	You cannot create a rule for the specified listener.	El listener especificado no admite crear reglas de reenvío.
400	Mismatch.SlbSpecTypeAndListenerProtocol	The SlbSpecType and ListenerProtocol are mismatched.	El tipo de especificación de la instancia no coincide con el tipo de listener.
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.	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.
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.