Crée un écouteur HTTPS.
Description de l'opération
Précautions
Un écouteur nouvellement créé est dans l'état stopped. Après avoir créé un écouteur, appelez l'opération StartLoadBalancerListener pour démarrer l'écouteur afin de transférer le trafic.
Avant de commencer
Une instance Classic Load Balancer (CLB) est créée. Pour plus d'informations, consultez CreateLoadBalancer.
Testez maintenant
Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.
Test
Autorisation RAM
|
slb:CreateLoadBalancerHTTPSListener |
create |
*acl.
*certificate.
*loadbalancer.
|
|
Aucune |
Paramètres de requête
|
Paramètre |
Type |
Requis |
Description |
Exemple |
| RegionId |
string |
Non |
L'identifiant de la région de l'instance CLB. Vous pouvez obtenir l'identifiant de la région à partir de la liste Régions et zones ou en appelant l'opération DescribeRegions. |
cn-hangzhou |
| LoadBalancerId |
string |
Oui |
L'identifiant de l'instance CLB. |
lb-bp1o94dp5i6earr**** |
| Bandwidth |
integer |
Oui |
La bande passante maximale de l'écouteur. Unité : Mbit/s. Valeurs valides :
|
-1 |
| ListenerPort |
integer |
Oui |
Le port frontal utilisé par l'instance. Valeurs valides : 1 à 65535. |
80 |
| BackendServerPort |
integer |
Non |
Le port backend utilisé par l'instance. Valeurs valides : 1 à 65535. Ce paramètre est requis si vous n'utilisez pas de groupe vServer (VServerGroupId n'est pas spécifié). |
80 |
| Tag |
array<object> |
Non |
Les balises. |
|
|
object |
Non |
Les balises. |
||
| Key |
string |
Non |
La clé de balise de l'écouteur. Valeurs valides de N : 1 à 20. La clé de balise ne peut pas être une chaîne vide. La clé de balise peut comporter jusqu'à 64 caractères et ne peut pas commencer par |
TestKey |
| Value |
string |
Non |
La valeur de balise de l'écouteur. Valeurs valides de N : 1 à 20. La valeur de balise peut être une chaîne vide. La valeur de balise peut comporter jusqu'à 128 caractères et ne peut pas commencer par |
TestValue |
| XForwardedFor |
string |
Non |
Indique si l'en-tête
|
on |
| Scheduler |
string |
Non |
L'algorithme de planification. Valeurs valides :
|
wrr |
| StickySession |
string |
Non |
Indique si la persistance de session doit être activée. Valeurs valides :
|
on |
| StickySessionType |
string |
Non |
La méthode utilisée pour gérer les cookies. Valeurs valides : insert et server.
Lorsqu'un client accède à l'instance Server Load Balancer pour la première fois, l'instance Server Load Balancer insère un cookie dans la réponse (insère SERVERID dans la réponse HTTP/HTTPS). La prochaine fois que le client envoie une requête avec ce cookie, l'instance Server Load Balancer transfère la requête au serveur backend qui a été précédemment enregistré.
Lorsque l'instance Server Load Balancer découvre un cookie défini par l'utilisateur, elle réécrit le cookie d'origine. La prochaine fois que le client envoie une requête avec le nouveau cookie, l'instance Server Load Balancer transfère la requête au serveur backend qui a été précédemment enregistré. Remarque
Ce paramètre est requis lorsque StickySession est défini sur on. |
insert |
| CookieTimeout |
integer |
Non |
Le délai d'expiration du cookie. Unité : secondes. Valeurs valides : 1 à 86400. Remarque
Ce paramètre est requis lorsque StickySession est défini sur on et que StickySessionType est défini sur insert. |
500 |
| Cookie |
string |
Non |
Le cookie configuré sur le serveur. Le cookie doit comporter de 1 à 200 caractères et ne peut contenir que des lettres ASCII et des chiffres. Il ne peut pas contenir de virgules (,), de points-virgules (;) ou d'espaces. Il ne peut pas commencer par un signe dollar ($). Remarque
Ce paramètre est requis lorsque StickySession est défini sur on et que StickySessionType est défini sur server. |
testCookie |
| HealthCheck |
string |
Oui |
Indique si les contrôles de santé doivent être activés. Valeurs valides :
|
on |
| HealthCheckMethod |
string |
Non |
La méthode de contrôle de santé utilisée par le contrôle de santé HTTP. Valeurs valides : head et get. Remarque
Ce paramètre prend effet uniquement lorsque HealthCheck est défini sur on. |
get |
| HealthCheckDomain |
string |
Non |
Le nom de domaine utilisé pour les contrôles de santé. Valeurs valides :
Remarque
Ce paramètre prend effet uniquement lorsque HealthCheck est défini sur on. |
172.XX.XX.16 |
| HealthCheckURI |
string |
Non |
L'URI utilisée pour les contrôles de santé. L'URI doit comporter de 1 à 80 caractères et peut contenir des lettres, des chiffres et les caractères spéciaux suivants : Remarque
Ce paramètre prend effet uniquement lorsque HealthCheck est défini sur on. |
/test/index.html |
| HealthyThreshold |
integer |
Non |
Le nombre de contrôles de santé réussis consécutifs qui doivent se produire avant qu'un serveur backend soit déclaré sain (de fail à success). Valeurs valides : 2 à 10. Remarque
Ce paramètre prend effet uniquement lorsque HealthCheck est défini sur on. |
4 |
| UnhealthyThreshold |
integer |
Non |
Le nombre de contrôles de santé échoués consécutifs qui doivent se produire avant qu'un serveur backend soit déclaré non sain (de success à fail). Valeurs valides : 2 à 10. Remarque
Ce paramètre prend effet uniquement lorsque HealthCheck est défini sur on. |
4 |
| HealthCheckTimeout |
integer |
Non |
Le temps d'attente pour une réponse d'un contrôle de santé. Si l'instance ECS backend ne répond pas dans le délai imparti, le contrôle de santé échoue. Unité : secondes. Valeurs valides : 1 à 300. Remarque
Ce paramètre prend effet uniquement lorsque HealthCheck est défini sur on. |
3 |
| HealthCheckConnectPort |
integer |
Non |
Le port utilisé pour les contrôles de santé. Valeurs valides : 1 à 65535. Remarque
Ce paramètre prend effet uniquement lorsque HealthCheck est défini sur on. |
8080 |
| HealthCheckInterval |
integer |
Non |
L'intervalle entre deux contrôles de santé consécutifs. Unité : secondes. Valeurs valides : 1 à 50. Remarque
Ce paramètre prend effet uniquement lorsque HealthCheck est défini sur on. |
5 |
| HealthCheckHttpCode |
string |
Non |
Le code d'état HTTP qui indique un contrôle de santé réussi. Séparez plusieurs codes d'état par des virgules (,). Valeurs valides : http_2xx, http_3xx, http_4xx et http_5xx. Remarque
Ce paramètre prend effet uniquement lorsque HealthCheck est défini sur on. |
http_2xx,http_3xx |
| ServerCertificateId |
string |
Non |
L'identifiant du certificat de serveur. |
idkp-123-cn-test-**** |
| VServerGroupId |
string |
Non |
L'identifiant du groupe vServer. |
rsp-cige6j5e7p**** |
| CACertificateId |
string |
Non |
L'identifiant du certificat CA. Si vous téléchargez à la fois un certificat CA et un certificat de serveur, l'authentification mutuelle est utilisée. Si vous téléchargez uniquement un certificat de serveur, l'authentification unidirectionnelle est utilisée. |
139a00604ad-cn-east-hangzh**** |
| XForwardedFor_SLBIP |
string |
Non |
Indique si l'en-tête
|
on |
| XForwardedFor_SLBID |
string |
Non |
Indique si l'en-tête
|
on |
| XForwardedFor_proto |
string |
Non |
Indique si l'en-tête
|
on |
| Gzip |
string |
Non |
Indique si la compression
|
on |
| AclId |
string |
Non |
L'identifiant de la liste de contrôle d'accès (ACL) liée à l'écouteur. Remarque
Ce paramètre est requis lorsque AclStatus est défini sur on. |
acl-a2do9e413e0spzasx**** |
| AclType |
string |
Non |
Le type de contrôle d'accès. Valeurs valides :
Si une liste blanche est activée mais qu'aucune adresse IP n'est ajoutée au groupe de stratégies de contrôle d'accès, l'écouteur SLB transfère toutes les requêtes.
Si une liste noire est activée mais qu'aucune adresse IP n'est ajoutée au groupe de stratégies de contrôle d'accès, l'écouteur SLB transfère toutes les requêtes. Remarque
Ce paramètre prend effet uniquement lorsque AclStatus est défini sur on. |
white |
| AclStatus |
string |
Non |
Indique si le contrôle d'accès doit être activé. Valeurs valides :
|
off |
| Description |
string |
Non |
Le nom personnalisé de l'écouteur. Le nom doit comporter de 1 à 256 caractères et peut contenir des caractères chinois, des lettres, des chiffres, des traits d'union (-), des barres obliques (/), des points (.) et des traits de soulignement (_). |
HTTPS_443 |
| IdleTimeout |
integer |
Non |
Le délai d'expiration de la connexion inactive. Valeurs valides : 1 à 60. Valeur par défaut : 15. Unité : secondes. Si aucune requête d'accès n'est reçue dans le délai d'expiration spécifié, l'instance Server Load Balancer interrompt temporairement la connexion actuelle et rétablit une nouvelle connexion à l'arrivée de la requête suivante. |
12 |
| RequestTimeout |
integer |
Non |
Le délai d'expiration de la requête. Valeurs valides : 1 à 180. Valeur par défaut : 60. Unité : secondes. Si aucune réponse n'est reçue du serveur backend dans le délai d'expiration spécifié, l'instance Server Load Balancer cesse d'attendre et renvoie un code d'erreur HTTP 504 au client. |
23 |
| EnableHttp2 |
string |
Non |
Indique si la fonctionnalité HTTP/2 doit être activée. Valeurs valides :
|
off |
| TLSCipherPolicy |
string |
Non |
La stratégie de sécurité qui contient les versions de protocole TLS prises en charge et les suites d'algorithmes de chiffrement pour HTTPS.
|
tls_cipher_policy_1_1 |
| XForwardedFor_SLBPORT |
string |
Non |
Indique si l'en-tête
|
off |
| XForwardedFor_ClientSrcPort |
string |
Non |
Indique si l'en-tête
|
off |
Éléments de réponse
|
Élément |
Type |
Description |
Exemple |
|
object |
|||
| RequestId |
string |
L'identifiant de la requête. |
CEF72CEB-54B6-4AE8-B225-F876FF7BA984 |
Exemples
JSON format
{
"RequestId": "CEF72CEB-54B6-4AE8-B225-F876FF7BA984"
}
Codes d'erreur
|
Code de statut HTTP |
Code d'erreur |
Message d'erreur |
Description |
|---|---|---|---|
| 400 | ParamDuplicateError | The specified parameter value of XForwardedFor_ClientCertSubjectDNAlias is duplicate. Please change to a different one. | Le paramètre XForwardedFor_ClientCertClientVerifyAlias est en double. |
| 400 | IpVersionConflict | The ip version of this LoadBalancer and the Acl is conflict. | La version IP de l'instance Server Load Balancer spécifiée est en conflit avec le type d'IP pris en charge par l'ACL. |
| 400 | InvalidParameter.IdleTimeout | The specified IdleTimeout exceeds the limit. | Le paramètre IdleTimeout spécifié n'est pas valide. Vérifiez les contraintes du paramètre et réessayez après avoir apporté les corrections nécessaires. |
| 400 | InvalidParameter.RequestTimeout | The specified RequestTimeout exceeds the limit. | Le RequestTimeout spécifié n'est pas valide. Vérifiez les contraintes du paramètre et réessayez. |
| 400 | ListenerForwardNotSupport | X-Forward-For is not supported to a ipv6 instance. | Les instances SLB IPv6 ne prennent pas en charge X-Forwarded-For. |
| 400 | InvalidParameter.RegionNotSupport | The region does not support the parameter: %s. | Le paramètre spécifié n'est pas pris en charge dans la région actuelle. |
| 400 | InvalidParameter.SpecNotSupport | The loadBalancer of shared spec does not support the parameter: %s. | Le paramètre spécifié n'est pas pris en charge par les instances SLB à ressources partagées. |
| 400 | ListenerProcessing | A previous configuration of the listener is pending,please try again later. | L'écouteur actuel est en cours de configuration. Réessayez plus tard. |
| 400 | Certkey.Forbidden | The specified certkey is not owned by the current user. | Le certificat et la clé spécifiés n'appartiennent pas à l'utilisateur actuel. |
| 400 | InvalidParameter.ListenerPortConflict | There is conflict listener port exists. | Le port d'écoute spécifié existe déjà. |
| 400 | ResourceNotAvailible.HttpsListener | The specified Zone did not have enough resource. | Ressources insuffisantes dans la zone spécifiée. |
| 400 | AclNotExist | Acl does not exist. | L'ACL spécifiée n'existe pas. |
| 400 | OperationUnsupported.CreateLoadBalancerLayer7Listener | The slb instance does not support create HTTP or HTTPS listener. | L'instance SLB actuelle ne prend pas en charge la création d'écouteurs HTTP ou HTTPS. |
| 400 | InvalidParameter.VServerGroupId | The MasterSlaveServerGroup can not be attached to HTTP or HTTPS listener. | Les écouteurs HTTP ou HTTPS ne prennent pas en charge les groupes de serveurs principal/secondaire. |
| 400 | MissingParam.HealthCheckDomain | The HealthCheckDomain is required when HealthCheckHttpVersion is http1.1. | Le paramètre HealthCheckDomain est manquant. |
| 400 | InvalidParameter.HealthCheckHttpVersion | The param HealthCheckHttpVersion is invalid. | Le paramètre HealthCheckHttpVersion spécifié n'est pas valide. Vérifiez les contraintes du paramètre et réessayez après avoir apporté les corrections nécessaires. |
| 400 | Duplicated.AclEntry | %s. | %s |
| 400 | CertificateNotExist | The specified CertificateId does not exist. | Le certificat spécifié n'existe pas. |
| 400 | OperationFailed.InsufficientResources | The loadbalancer does not support this operation because of insufficient resources. | L'opération a échoué car l'instance Server Load Balancer ne prend pas en charge cette opération en raison de ressources insuffisantes. |
| 400 | InvalidTLSPolicyId.NotExist | The specified TLS cipher policy does not exist. | La stratégie de sécurité TLS spécifiée n'existe pas. |
| 400 | TLSPolicyConfiguring | The specified TLS cipher policy is configuring. | La TLSCipherPolicy spécifiée est en cours de modification. |
| 400 | TLSCipherPolicyVipRelationOverLimit | The number of listeners associated with a policy has exceeded. | Le nombre d'instances TLSCipherPolicy associées à l'écouteur a atteint la limite du quota. |
| 400 | CertificateTypeMismatched | The certificate type does not match. | Le type du certificat spécifié ne correspond pas. |
| 400 | MissingParam.ServerCertificates | Server certificates are required. | Le paramètre ServerCertificates est manquant. |
| 400 | TooManyCertificates | The number of certificates must not be greater than one. | Le nombre de certificats ne peut pas dépasser 1. |
| 400 | CnCertificateNotSupport | The cn certificate is not support. | Les certificats d'algorithme cryptographique national chinois (SM) ne sont pas pris en charge. |
| 400 | InvalidParam.CertificateBindingType | The param CertificateBindingType is invalid. | Le paramètre CertificateBindingType spécifié n'est pas valide. Vérifiez les contraintes du paramètre et réessayez après avoir apporté les modifications nécessaires. |
| 400 | InvalidParamSize.ServerCertificates | The size of param ServerCertificates is invalid. | La longueur des ServerCertificates spécifiés n'est pas valide. Vérifiez les contraintes du paramètre et réessayez. |
| 400 | TooManyCertificates.ServerCertificates | The number of certificates must not be greater than one. | Le nombre de certificats ne peut pas dépasser 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. | L'instance spécifiée ne prend pas en charge la création d'écouteurs de type TCP/SSL. |
| 400 | LbSupportTcpsslOnly | The specified load balancer supports TCP SSL type listener only. | L'instance spécifiée prend uniquement en charge la création d'écouteurs de type TCP/SSL. |
| 400 | ListenerNotSupportRule | You cannot create a rule for the specified listener. | L'écouteur spécifié ne prend pas en charge la création de règles de transfert. |
| 400 | Mismatch.SlbSpecTypeAndListenerProtocol | The SlbSpecType and ListenerProtocol are mismatched. | Le type de spécification d'instance ne correspond pas au type d'écouteur. |
| 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. | Le nombre d'écouteurs pouvant être associés à l'ACL spécifiée a atteint la limite du quota. |
| 400 | QuotaLimitExceeds.AclAttachedToListener | The number of Acl bound listeners has reached the quota limit | Le nombre d'écouteurs associés à l'ACL a atteint la limite du quota. |
| 400 | QuotaLimitExceeds.TotalAclEntry | The number of Acl entries has reached the quota limit. | Le nombre d'entrées de la liste de contrôle d'accès a atteint la limite du quota. |
| 400 | QuotaLimitExceeds.AclListenerOverLimit | This acl has reached the limit of binding to listeners. | Le nombre d'écouteurs pouvant être associés à l'ACL spécifiée a atteint la limite du quota. |
| 404 | ResourceNotFound.Certificate | The specified resource is not found. |
Consultez Codes d'erreur pour la liste complète.
Notes de version
Consultez Notes de version pour la liste complète.