Tous les produits
Search
Centre de documentation

Edge Security Acceleration:CreateTransportLayerApplication

Dernière mise à jour :Aug 07, 2026

Crée une application d'accélération de couche 4.

Description de l'opération

Le site sélectionné doit être activé. Après avoir créé un site, appelez l'opération VerifySite pour vérifier le site. Un site qui réussit la vérification est automatiquement activé, ce qui signifie que le paramètre de réponse Passed est défini sur 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:CreateTransportLayerApplication

create

*Site

acs:esa:{#regionId}:{#accountId}:site/{#SiteId}

Aucune 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. Le site doit être activé.

123456****

RecordName

string

Oui

Le nom de domaine de l'application de couche 4.

aaa.example.com

Rules

array<object>

Oui

La liste des règles de transfert.

object

Oui

Les détails de la règle. Pour chaque règle, tous les paramètres sauf le commentaire sont requis.

Protocol

string

Oui

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

Oui

Le port de périphérie. Les formats suivants sont pris en charge :

  • 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 de périphérie au sein d'une même règle et entre plusieurs règles ne doivent pas se chevaucher.

80

SourceType

string

Oui

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

Oui

Le port du serveur d'origine. Les formats suivants sont pris en charge :

  • Un port unique. Lorsque le port du serveur d'origine est un port unique, toute combinaison valide de ports de périphérie 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 si le port de périphérie est également une plage de ports, et la taille de la plage doit correspondre à celle du port de périphérie. Par exemple, si le port de périphérie est 90-93, vous ne pouvez pas définir le port du serveur d'origine sur 81-85 car la taille de la plage du port du serveur d'origine est de 5 tandis que celle du port de périphérie est de 4, ce qui est incohérent.

80

ClientIPPassThroughMode

string

Oui

Le protocole de transmission de l'IP client. Valeurs valides :

  • off : désactivé.

  • PPv1 : PROXY Protocol v1. Prend en charge la transmission de l'IP client pour TCP.

  • PPv2 : PROXY Protocol v2. Prend en charge la transmission de l'IP client pour TCP et UDP.

  • SPP : Simple Proxy Protocol. Prend en charge la transmission de l'IP client pour UDP.

Valeurs valides :

  • SPP :

    Protocole Simple Proxy Protocol.

  • PPv2 :

    PROXY Protocol v2

  • off :

    Désactivé.

  • PPv1 :

    PROXY Protocol v1

SPP

Source

string

Oui

La valeur spécifique de l'origine, qui doit correspondre au type d'origine.

1.1.1.1

Comment

string

Non

Le commentaire de la règle (facultatif).

Test

IpAccessRule

string

Non

Le commutateur de règle d'accès IP. Lorsqu'il est activé, les règles d'accès IP dans 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

Indique si IPv6 doit être activé. Cette fonctionnalité est désactivée par défaut. Valeurs valides :

  • on : activé.

  • off : désactivé.

Valeurs valides :

  • off :

    Désactivé.

  • on :

    Activé.

off

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é.

Valeurs valides :

  • off :

    Désactivé.

  • on :

    Activé.

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

Les détails de la réponse.

RequestId

string

L'identifiant de la requête.

9e5448c7-edaf-49aa-9887-0fcd0832306c

ApplicationId

integer

L'identifiant de l'application de couche 4.

165503967****

Exemples

JSON format

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

Codes d'erreur

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 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 TransportLayerApplicationConflict The Layer -4 accelerated application conflicts with other applications. Check whether the application name and host record conflict with other applications in the site. The Layer -4 accelerated application conflicts with other applications. Check whether the application name and host record conflict with other applications in the site.
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 IpaResourceUnavailable The resource is unavailable. The resource is unavailable.
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 Site.NotActive The status of the applied site or site is not activated. The status of the applied site or site is not activated.
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"

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

Notes de version

Consultez Notes de version pour la liste complète.