Todos os produtos
Search
Central de documentação

Edge Security Acceleration:CreateTransportLayerApplication

Última atualização: Jun 25, 2026

Cria uma aplicação de aceleração de camada 4.

Descrição da operação

O site selecionado deve estar ativado. Após criar um site, chame a operação VerifySite para verificar o site. Um site que passa na verificação é ativado automaticamente, o que significa que o parâmetro de resposta Passed é definido como true.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

  • Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.

  • API: A API que você pode chamar para executar a ação.

  • Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.

  • Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.

    • Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.

    • Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.

  • Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.

  • Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

esa:CreateTransportLayerApplication

create

*Site

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

Nenhuma Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

SiteId

integer

Sim

O ID do site. Você pode chamar a operação ListSites para obter o ID do site. O site deve estar ativado.

123456****

RecordName

string

Sim

O nome de domínio da aplicação de camada 4.

aaa.example.com

Rules

array<object>

Sim

A lista de regras de encaminhamento.

object

Sim

Os detalhes da regra. Para cada regra, todos os parâmetros, exceto o comentário, são obrigatórios.

Protocol

string

Sim

O protocolo da regra de encaminhamento. Valores válidos:

  • TCP: protocolo TCP.

  • UDP: protocolo UDP.

Valores válidos:

  • TCP :

    TCP 协议

  • UDP :

    UDP 协议

TCP

EdgePort

string

Sim

A porta de borda. Os seguintes formatos são suportados:

  • Uma única porta, como 80.

  • Um intervalo de portas, como 81-85, que representa as portas 81, 82, 83, 84 e 85.

  • Uma combinação de portas e intervalos de portas separados por vírgulas, como 80,81-85,90, que representa as portas 80, 81, 82, 83, 84, 85 e 90.

As portas de borda dentro de uma única regra e em várias regras não devem se sobrepor.

80

SourceType

string

Sim

O tipo de origem. Valores válidos:

  • ip: endereço IP.

  • domain: nome de domínio.

  • OP: pool IPAM de origem.

  • LB: load balancer.

Valores válidos:

  • OP :

    源地址池

  • LB :

    负载均衡器

  • ip :

    IP

  • domain :

    域名

ip

SourcePort

string

Sim

Porta do servidor de origem. Os seguintes formatos são suportados:

  • Uma única porta. Quando a porta do servidor de origem é uma única porta, qualquer combinação válida de portas de borda é suportada.

  • Um intervalo de portas. A porta do servidor de origem pode ser definida como um intervalo de portas apenas quando a porta de borda também é um intervalo de portas, e o tamanho do intervalo deve corresponder ao intervalo da porta de borda. Por exemplo, se a porta de borda for 90-93, você não pode definir a porta do servidor de origem como 81-85 porque o tamanho do intervalo da porta do servidor de origem é 5, enquanto o tamanho do intervalo da porta de borda é 4, o que é inconsistente.

80

ClientIPPassThroughMode

string

Sim

O protocolo de passagem de IP do cliente. Valores válidos:

  • off: desativado.

  • PPv1: PROXY Protocol v1. Suporta passagem de IP do cliente para TCP.

  • PPv2: PROXY Protocol v2. Suporta passagem de IP do cliente para TCP e UDP.

  • SPP: Simple Proxy Protocol. Suporta passagem de IP do cliente para UDP.

Valores válidos:

  • SPP :

    Simple Proxy Protocol 协议

  • PPv2 :

    PROXY Protocol v2 协议

  • off :

    不传递

  • PPv1 :

    PROXY Protocol v1 协议

SPP

Source

string

Sim

O valor específico da origem, que deve corresponder ao tipo de origem.

1.1.1.1

Comment

string

Não

O comentário para a regra (opcional).

Test

IpAccessRule

string

Não

O interruptor da regra de acesso por IP. Quando ativado, as regras de acesso por IP no WAF entram em vigor para a aplicação de camada 4. Valores válidos:

  • on: ativado.

  • off: desativado.

Valores válidos:

  • off :

    Desativado.

  • on :

    Ativado.

on

Ipv6

string

Não

Especifica se o IPv6 deve ser ativado. Este recurso está desativado por padrão. Valores válidos:

  • on: ativado.

  • off: desativado.

Valores válidos:

  • off :

    Desativado.

  • on :

    Ativado.

off

CrossBorderOptimization

string

Não

Especifica se a otimização de acesso à rede para a China continental deve ser ativada. Este recurso está desativado por padrão. Valores válidos:

  • on: ativado.

  • off: desativado.

Valores válidos:

  • off :

    Desativado.

  • on :

    Ativado.

on

StaticIp

string

Não

Especifica se o IP estático deve ser ativado. Este recurso está desativado por padrão. Valores válidos:

  • on: ativado.

  • off: desativado.

Valores válidos:

  • off :

    Desativado.

  • on :

    Ativado.

off

KeepAliveProtection

string

Não

Especifica se a proteção keep-alive deve ser ativada. Este recurso está desativado por padrão. Valores válidos:

  • on: ativado.

  • off: desativado.

Valores válidos:

  • off :

    Desativado.

  • on :

    Ativado.

off

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Os detalhes da resposta.

RequestId

string

O ID da solicitação.

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

ApplicationId

integer

O ID da aplicação de camada 4.

165503967****

Exemplos

Resposta de sucesso

JSON formato

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

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

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"

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.