Modifica las configuraciones de un listener HTTPS.
Descripción de la operación
Ha creado una instancia de Classic Load Balancer (CLB). Para obtener más información, consulte CreateLoadBalancer.
Ha creado un listener HTTPS. Para obtener más información, consulte CreateLoadBalancerHTTPSListener.
Pruébelo ahora
Test
Autorización de RAM
|
Action |
Nivel de acceso |
Tipo de recurso |
Clave de condición |
Acción dependiente |
|
slb:SetLoadBalancerHTTPSListenerAttribute |
update |
acl.
*certificate.
*loadbalancer.
|
|
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 |
| XForwardedFor |
string |
No |
Especifica si se debe utilizar el campo de encabezado
|
on |
| Scheduler |
string |
No |
El algoritmo de programación. Valores válidos:
|
wrr |
| StickySession |
string |
No |
Especifica si se debe habilitar la persistencia de sesión. Valores válidos:
|
on |
| StickySessionType |
string |
No |
El método utilizado para gestionar la cookie. Valores válidos:
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.
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 |
| 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:
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.
|
139a00604ad-cn-east-**** |
| VServerGroup |
string |
No |
Especifica si se debe utilizar un grupo vServer. Valores válidos:
|
on |
| VServerGroupId |
string |
No |
El ID del grupo vServer. |
rsp-cige6j**** |
| XForwardedFor_SLBIP |
string |
No |
Especifica si se debe utilizar el campo de encabezado
|
on |
| XForwardedFor_SLBID |
string |
No |
Especifica si se debe utilizar el campo de encabezado
|
on |
| XForwardedFor_proto |
string |
No |
Especifica si se debe utilizar el campo de encabezado
|
on |
| Gzip |
string |
No |
Especifica si se debe habilitar la compresión
|
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:
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.
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:
|
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
|
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_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
|
off |
| XForwardedFor_ClientSrcPort |
string |
No |
Especifica si se debe utilizar el campo de encabezado
|
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.