SetLoadBalancerHTTPSListenerAttribute - - Centre de documentation Alibaba Cloud

Modifie les configurations d'un écouteur HTTPS.

Description de l'opération

Vous avez créé une instance Classic Load Balancer (CLB). Pour plus d'informations, consultez CreateLoadBalancer.
Vous avez créé un écouteur HTTPS. Pour plus d'informations, consultez CreateLoadBalancerHTTPSListener.

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

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.
API : l'API que vous pouvez appeler pour exécuter l'action.
Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.
Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.
- Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.
- Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.
Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.
Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

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

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
RegionId	string	Non	L'identifiant de la région de l'instance Classic Load Balancer (CLB). Vous pouvez appeler l'opération DescribeRegions pour interroger les identifiants de région.	cn-hangzhou
LoadBalancerId	string	Oui	L'identifiant de l'instance Classic Load Balancer (CLB).	lb-sjhfdji****
ListenerPort	integer	Oui	Le port frontal utilisé par l'instance Classic Load Balancer (CLB). Valeurs valides : 1 à 65535.	80
Bandwidth	integer	Non	La bande passante crête de l'écouteur. Unité : Mbit/s. Valeurs valides : -1 : La bande passante crête n'est pas limitée.	-1
XForwardedFor	string	Non	Indique si le champ d'en-tête `X-Forwarded-For` doit être utilisé pour obtenir l'adresse IP réelle du client. Valeurs valides : on : oui. off : non.	on
Scheduler	string	Non	L'algorithme de planification. Valeurs valides : wrr : Les serveurs backend avec des poids plus élevés reçoivent plus de requêtes que les serveurs backend avec des poids plus faibles. rr : Les requêtes sont distribuées aux serveurs backend de manière séquentielle.	wrr
StickySession	string	Non	Indique si la persistance de session doit être activée. Valeurs valides : on : oui. off : non.	on
StickySessionType	string	Non	La méthode utilisée pour gérer le cookie. Valeurs valides : insert : insérer un cookie. Lorsqu'un client accède à Server Load Balancer pour la première fois, Server Load Balancer insère un cookie dans la réponse (insère SERVERID dans la réponse HTTP/HTTPS). La fois suivante où le client envoie une requête avec ce cookie, Server Load Balancer transfère la requête au serveur backend qui a été précédemment enregistré. server : réécrire le cookie. Lorsque Server Load Balancer découvre qu'un utilisateur a défini un cookie personnalisé, il réécrit le cookie d'origine. La fois suivante où le client envoie une requête avec le nouveau cookie, 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. Valeurs valides : 1 à 86400 (secondes). 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. La valeur doit comporter de 1 à 200 caractères et ne peut contenir que des lettres ASCII et des chiffres. Elle ne peut pas contenir de virgules (,), de points-virgules (;) ou d'espaces, et 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	Non	Indique si les bilans de santé doivent être activés. Valeurs valides : on : oui. off : non.	on
HealthCheckMethod	string	Non	La méthode de bilan de santé utilisée par le bilan 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 bilans de santé. Valeurs valides : $_ip : l'adresse IP privée du serveur backend. Si vous spécifiez $_ip ou ne spécifiez pas ce paramètre, Server Load Balancer utilise l'adresse IP privée de chaque serveur backend comme nom de domaine pour les bilans de santé. domain : Le nom de domaine doit comporter de 1 à 80 caractères et ne peut contenir que des lettres, des chiffres, des points (.) et des tirets (-). 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 bilans de santé. La valeur doit comporter de 1 à 80 caractères et peut contenir des lettres, des chiffres, des tirets (-), des barres obliques (/), des points (.), des signes de pourcentage (%), des points d'interrogation (?), des croisillons (#) et des perluètes (&). L'URI ne peut pas contenir uniquement une barre oblique (/) mais doit commencer par une barre oblique (/). Remarque Ce paramètre prend effet uniquement lorsque HealthCheck est défini sur on.	/test/index.html
HealthyThreshold	integer	Non	Le nombre de bilans 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 bilans 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 bilan de santé. Si l'instance ECS backend ne répond pas dans le délai spécifié, le bilan de santé échoue. Unité : secondes. Valeurs valides : 1 à 300. Remarque Ce paramètre prend effet uniquement lorsque HealthCheck est défini sur on.	3
HealthCheckInterval	integer	Non	L'intervalle entre deux bilans 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
HealthCheckConnectPort	integer	Non	Le port utilisé pour les bilans de santé. Valeurs valides : 1 à 65535. Remarque Ce paramètre prend effet uniquement lorsque HealthCheck est défini sur on.	8080
HealthCheckHttpCode	string	Non	Le code d'état HTTP qui indique un bilan de santé réussi. Séparez plusieurs codes d'état HTTP 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-te****
CACertificateId	string	Non	L'identifiant du certificat CA. Si vous importez à la fois un certificat CA et un certificat de serveur, l'authentification mutuelle est utilisée. Si vous importez uniquement un certificat de serveur, l'authentification unidirectionnelle est utilisée.	139a00604ad-cn-east-****
VServerGroup	string	Non	Indique si un groupe vServer doit être utilisé. Valeurs valides : on : oui. off : non.	on
VServerGroupId	string	Non	L'identifiant du groupe vServer.	rsp-cige6j****
XForwardedFor_SLBIP	string	Non	Indique si le champ d'en-tête `SLB-IP` doit être utilisé pour obtenir l'adresse IP virtuelle (VIP) de la requête client. Valeurs valides : on : oui. off : non.	on
XForwardedFor_SLBID	string	Non	Indique si le champ d'en-tête `SLB-ID` doit être utilisé pour obtenir l'identifiant de l'instance SLB. Valeurs valides : on : oui. off : non.	on
XForwardedFor_proto	string	Non	Indique si le champ d'en-tête `X-Forwarded-Proto` doit être utilisé pour obtenir le protocole de l'écouteur de l'instance SLB. Valeurs valides : on : oui. off : non.	on
Gzip	string	Non	Indique si la compression `Gzip` doit être activée pour des types de fichiers spécifiques. Valeurs valides : on : oui. off : non.	on
AclId	string	Non	L'identifiant de la liste de contrôle d'accès (ACL) liée à l'écouteur. 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 : white : Seules les requêtes provenant des adresses IP ou des blocs CIDR du groupe de stratégies de contrôle d'accès sélectionné sont transférées. Les listes blanches s'appliquent aux scénarios dans lesquels vous souhaitez autoriser uniquement des adresses IP spécifiques à accéder à votre service. L'activation d'une liste blanche présente certains risques. Une fois la liste blanche activée, seules les adresses IP de la liste blanche peuvent accéder à l'écouteur SLB. 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. black : Toutes les requêtes provenant des adresses IP ou des blocs CIDR du groupe de stratégies de contrôle d'accès sélectionné sont rejetées. Les listes noires s'appliquent aux scénarios dans lesquels vous souhaitez bloquer l'accès à partir d'adresses IP spécifiques. 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 : on : oui. off : non.	off
IdleTimeout	integer	Non	Le délai d'expiration des connexions inactives. Valeurs valides : 1 à 60. Unité : secondes. Valeur par défaut : 15. Si aucune requête d'accès n'est reçue pendant le délai d'expiration spécifié, Server Load Balancer interrompt temporairement la connexion actuelle et rétablit une nouvelle connexion à l'arrivée de la requête suivante.	23
RequestTimeout	integer	Non	Le délai d'expiration de la requête. Valeurs valides : 1 à 180. Unité : secondes. Valeur par défaut : 60. Si aucune réponse n'est reçue du serveur backend pendant le délai d'expiration spécifié, Server Load Balancer cesse d'attendre et renvoie un code d'erreur HTTP 504 au client.	223
EnableHttp2	string	Non	Indique si la fonctionnalité `HTTP 2.0` doit être activée. Valeurs valides : on : oui. off : non.	off
TLSCipherPolicy	string	Non	La stratégie de sécurité qui contient les versions du protocole TLS et les suites d'algorithmes de chiffrement prises en charge disponibles pour HTTPS. tls_cipher_policy_1_0 : Versions TLS prises en charge : TLSv1.0, TLSv1.1 et TLSv1.2. Suites d'algorithmes de chiffrement prises en charge : 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 et DES-CBC3-SHA. tls_cipher_policy_1_1 : Versions TLS prises en charge : TLSv1.1 et TLSv1.2. Suites d'algorithmes de chiffrement prises en charge : 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 et DES-CBC3-SHA. tls_cipher_policy_1_2 Versions TLS prises en charge : TLSv1.2. Suites d'algorithmes de chiffrement prises en charge : 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 et DES-CBC3-SHA. tls_cipher_policy_1_2_strict Versions TLS prises en charge : TLSv1.2. Suites d'algorithmes de chiffrement prises en charge : ECDHE-RSA-AES128-GCM-SHA256, ECDHE-RSA-AES256-GCM-SHA384, ECDHE-RSA-AES128-SHA256, ECDHE-RSA-AES256-SHA384, ECDHE-RSA-AES128-SHA et ECDHE-RSA-AES256-SHA. tls_cipher_policy_1_2_strict_with_1_3 Versions TLS prises en charge : TLSv1.2 et TLSv1.3. Suites d'algorithmes de chiffrement prises en charge : 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 et ECDHE-RSA-AES256-SHA.	tls_cipher_policy_1_2
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 tirets (-), des barres obliques (/), des points (.) et des traits de soulignement (_).	https_80
XForwardedFor_SLBPORT	string	Non	Indique si le champ d'en-tête `XForwardedFor_SLBPORT` doit être utilisé pour obtenir le port de l'écouteur de l'instance SLB. Valeurs valides : on : oui. off : non.	off
XForwardedFor_ClientSrcPort	string	Non	Indique si le champ d'en-tête `XForwardedFor_ClientSrcPort` doit être utilisé pour obtenir le port du client qui accède à l'instance SLB. Valeurs valides : on : oui. off : non.	off
DryRun	boolean	Non

É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	OperationFailed.ServerGroupInUse	The VServerGroup or MasterSlaveServerGroup can not be close for this listener.	L'opération a échoué car l'écouteur actuel ne prend pas en charge la désactivation du groupe de serveurs.
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	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	TooManyCertificates	The number of certificates must not be greater than one.	Le nombre de certificats ne peut pas dépasser 1.
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	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	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.
400	DryRunOperation	Request validation has been passed with DryRun flag set.	La requête DryRun a réussi la validation.
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.