UpdateTransportLayerApplication - Edge Security Acceleration

Modifie les configurations des règles de transfert d'une application de couche 4 pour un site spécifié.

Description de l'opération

Si ListTransportLayerApplications renvoie une liste d'applications d'accélération de couche 4 vide, utilisez CreateTransportLayerApplication pour créer une application d'accélération de couche 4, puis utilisez cette API pour modifier les configurations de l'application d'accélération de couche 4.

Lors de la création d'une application d'accélération de couche 4, le site sélectionné doit être un site activé. Après avoir créé un site, appelez l'API VerifySite pour le vérifier. Un site qui réussit la vérification est automatiquement activé, ce qui est indiqué par le paramètre de réponse Passed=true.

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.

esa:UpdateTransportLayerApplication

update

*All Resource

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
SiteId	integer	Oui	L'identifiant du site. Vous pouvez appeler l'opération ListSites pour obtenir l'identifiant du site.	123456****
ApplicationId	integer	Oui	L'identifiant de l'application de couche 4. Vous pouvez appeler l'opération ListTransportLayerApplications pour obtenir l'identifiant de l'application.	165503967****
Rules	array<object>	Non	La liste des règles de transfert. Pour chaque règle, tous les paramètres à l'exception du commentaire sont requis.
	object	Non	Les détails de la règle. Pour chaque règle, tous les paramètres à l'exception du commentaire sont requis.
Protocol	string	Non	Le protocole de la règle de transfert. Valeurs valides : TCP : protocole TCP. UDP : protocole UDP. Valeurs valides : TCP : Protocole TCP. UDP : Protocole UDP.	TCP
EdgePort	string	Non	Le port périphérique. Valeurs valides : Un port unique, tel que 80. Une plage de ports, telle que 81-85, qui représente les ports 81, 82, 83, 84 et 85. Une combinaison de ports et de plages de ports séparés par des virgules, telle que 80,81-85,90, qui représente les ports 80, 81, 82, 83, 84, 85 et 90. Les ports périphériques au sein d'une même règle et entre plusieurs règles ne peuvent pas se chevaucher.	80
SourceType	string	Non	Le type d'origine. Valeurs valides : ip : adresse IP. domain : nom de domaine. OP : pool IPAM d'origine. LB : équilibreur de charge. Valeurs valides : OP : Pool IPAM d'origine. LB : Équilibreur de charge. ip : IP domain : Nom de domaine.	ip
SourcePort	string	Non	Port du serveur d'origine. Valeurs valides : Un port unique. Lorsque le port du serveur d'origine est un port unique, toute combinaison de ports périphériques valide est prise en charge. Une plage de ports. Le port du serveur d'origine ne peut être défini sur une plage de ports que lorsque le port périphérique est une plage de ports, et la taille de la plage doit correspondre à la plage du port périphérique. Par exemple, si le port périphérique est 90-93, vous ne pouvez pas définir le port du serveur d'origine sur 81-85 car la plage du port du serveur d'origine est de 5 tandis que la plage du port périphérique est de 4, ce qui est incohérent.	80
ClientIPPassThroughMode	string	Non	Le protocole de transmission de l'IP client. Valeurs valides : off : désactivé. PPv1 : PROXY Protocol v1, qui prend en charge la transmission de l'IP client pour TCP. PPv2 : PROXY Protocol v2, qui prend en charge la transmission de l'IP client pour TCP et UDP. SPP : Simple Proxy Protocol, qui prend en charge la transmission de l'IP client pour UDP. Valeurs valides : SPP : Protocole Simple Proxy Protocol. PPv2 : Protocole PROXY Protocol v2 off : Non transmis. PPv1 : Protocole PROXY Protocol v1	SPP
Source	string	Non	La valeur spécifique de l'origine.	1.1.1.1
Comment	string	Non	Le commentaire de la règle.	123
IpAccessRule	string	Non	Le commutateur de règle d'accès IP. Lorsqu'il est activé, les règles d'accès IP du WAF prennent effet pour l'application de couche 4. Valeurs valides : on : activé. off : désactivé. Valeurs valides : off : Désactivé. on : Activé.	on
Ipv6	string	Non	Le commutateur IPv6. Valeurs valides : on : activé. off : désactivé. Valeurs valides : off : Désactivé. on : Activé.	on
CrossBorderOptimization	string	Non	Indique si l'optimisation de l'accès réseau pour la Chine continentale doit être activée. Cette fonctionnalité est désactivée par défaut. Valeurs valides : on : activé. off : désactivé. Valeurs valides : off : Désactivé. on : Activé.	on
StaticIp	string	Non	Indique si l'IP statique doit être activée. Cette fonctionnalité est désactivée par défaut. Valeurs valides : on : activé. off : désactivé.	off
KeepAliveProtection	string	Non	Indique si la protection keep-alive doit être activée. Cette fonctionnalité est désactivée par défaut. Valeurs valides : on : activé. off : désactivé. Valeurs valides : off : Désactivé. on : Activé.	off

Éléments de réponse

Élément	Type	Description	Exemple
	object	La réponse pour une requête réussie.
RequestId	string	L'identifiant de la requête.	9e5448c7-edaf-49aa-9887-0fcd0832306c

Exemples

JSON format

{
  "RequestId": "9e5448c7-edaf-49aa-9887-0fcd0832306c"
}

Codes d'erreur

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	InvalidParameter	The specified parameter is invalid.	The specified parameter is invalid.
400	ApplyVipError	Failed to apply for ip resources, please contact customer service.	Failed to apply for IP resources, please contact customer service.
400	InternalException	Failed to call the service. Try again later or contact technical support.	Failed to call the service. Try again later or contact technical support.
400	InvalidParameter.RecordData	Invalid record content. Adjust your configurations based on the API documentation.	Invalid record content. Adjust your configurations based on the API documentation.
400	InvalidParameter.RecordType	Invalid record type. Adjust your configurations based on the API documentation.	Invalid record type. Adjust your configurations based on the API documentation.
400	Instance.NotOnline	Your plan is unavailable due to an overdue payment. Complete the payment first.	Your plan is unavailable due to an overdue payment. Complete the payment first.
400	QuotaExceed.RecordCount	The maximum number of records has been reached. Delete some and try again or upgrade your plan.	The maximum number of records has been reached. Delete some and try again or upgrade your plan.
400	Record.Conflict	The specified record content conflicts with existing records. Adjust your configurations based on the related product documentation.	The specified record content conflicts with existing records. Adjust your configurations based on the related product documentation.
400	Site.ServiceBusy	This website is being configured. Try again later.	This website is being configured. Try again later.
400	TransportLayerApplicationNotExist	The layer -4 accelerated application of the current operation does not exist. Modify it and try again.	The layer -4 accelerated application of the current operation does not exist. Modify it and try again.
400	TransportLayerRulesExceedLimit	The configured forwarding rules have exceeded the maximum limit. Delete useless forwarding rules and try again.	The configured forwarding rules have exceeded the maximum limit. Delete useless forwarding rules and try again.
400	SourceCircleExist	The host record of the resource to be operated on is already the source station of another resource, or the source station of the current resource has been added as a host record. To avoid loopback, modify the host record or source station and retry.	The host record of the resource to be operated on is already the source station of another resource, or the source station of the current resource has been added as a host record. To avoid loopback, modify the host record or source station and retry.
400	InvalidParameter.InvalidRecordName	The record name you entered does not meet the specifications. Change the record name according to the product documentation.	The record name you entered does not meet the specifications. Please adjust the record name according to the product documentation.
400	EdgePortsOverlap	There is overlap between multiple edge ports, please check and try again after modification.	There is overlap between multiple edge ports, please check and try again after modification.
400	InvalidParameter.ClientIpPassThroughMode	Invalid client IP transfer protocol, please refer to the interface document and pass in valid parameters.	Invalid client IP transfer protocol, please refer to the interface document and pass in valid parameters.
400	InvalidParameter.RuleSource	The origin of the forwarding rule does not exist or is invalid. Enter the correct origin and try again.	The origin of the forwarding rule does not exist or is invalid. Enter the correct origin and try again.
400	InvalidParameter.Port	Invalid edge port or origin port. Enter a valid port as required in the interface document.	Invalid edge port or origin port. Enter a valid port as required in the interface document.
400	InvalidParameter.Protocol	Invalid port protocol. Enter a valid port protocol as required by the interface documentation.	Invalid port protocol. Enter a valid port protocol as required by the interface documentation.
400	InternalError	An internal exception occurred, please try again later.	An inner exception was triggered. Please try again later.
400	IpaNotActive	The ipa application is not active.	The ipa application is not active.
400	Record.NoResource	Failed to allocate resources for the record. Please submit a ticket for processing.	Failed to allocate resources for the record. Please submit a work order for processing.
400	InvalidParameter.PrivateIpAsSourceUnsupported	The provided source is an invalid private IP address. Please verify and resubmit.	The provided source is an invalid private IP address. Please verify and resubmit.
400	InvalidParameter.SourceIpInBlacklist	The provided source is an invalid private IP address. Please verify and resubmit.	The provided source is an invalid private IP address. Please verify and resubmit.
400	IPA.KeepAliveProtectionConflict	KeepAliveProtection is conflicted with StaticIp and CrossBorderOptimization, can not open at same time.	KeepAliveProtection is conflicted with StaticIp and CrossBorderOptimization, can not open at same time
400	IPA.CanNotEnableKeepAliveProtection	The site has one or more TCP/UDP proxied applications with keep-alive-protection enabled. Its acceleration region or plan can't be edited.	DDoS protection for Chinese mainland or outside the Chinese mainland can't be "Basic protection"