CreateForwardEntry - ENS: Central de Documentação do Alibaba Cloud

Adiciona uma entrada DNAT chamando CreateForwardEntry.

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

ens:CreateForwardEntry

create

*Todos os recursos.

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
NatGatewayId	string	Sim	O ID do gateway NAT.	nat-5t7nh1cfm6kxiszlttr38****
ExternalIp	string	Sim	O Elastic IP Address (EIP) que fornece acesso à rede pública. O EIP não deve estar ocupado por uma regra SNAT do mesmo gateway NAT. Você pode verificar o campo IpLists.UsingStatus retornado por DescribeNatGateways para confirmar que o EIP está no estado Idle.	121.XXX.XXX.28
ExternalPort	string	Sim	A porta externa ou intervalo de portas para encaminhamento de portas. O intervalo de portas deve estar entre 1 e 65535. Para encaminhar tráfego dentro de um intervalo de portas, separe as portas inicial e final com uma barra (/), como 10/20. Se ExternalPort for definido como um intervalo de portas, InternalPort também deve ser definido como um intervalo de portas com o mesmo número de portas. Por exemplo, se ExternalPort for definido como 10/20, InternalPort deve ser definido como 80/90.	22
InternalIp	string	Sim	O endereço IP privado da instância que se comunica com a Internet por meio da entrada DNAT.	10.0.XXX.XXX
InternalPort	string	Sim	A porta interna ou intervalo de portas para encaminhamento de portas. O intervalo de portas deve estar entre 1 e 65535. Para encaminhar tráfego dentro de um intervalo de portas, separe as portas inicial e final com uma barra (/), como 10/20.	22
ForwardEntryName	string	Não	O nome da regra DNAT. O nome deve ter de 2 a 128 caracteres e não pode começar com `http://` ou `https://`.	test0
IpProtocol	string	Não	O tipo de protocolo. Valores válidos: TCP: encaminha pacotes TCP. UDP: encaminha pacotes UDP. Any (padrão): encaminha todos os pacotes. Valores válidos: TCP : Protocolo TCP. UDP : Protocolo UDP. Any : Todos os protocolos.	Any
HealthCheckPort	integer	Não	A porta de verificação de integridade para DNAT. A porta deve estar dentro do intervalo de portas internas. Valor padrão: vazio.	80
StandbyExternalIp	string	Não	O EIP standby que fornece acesso à rede pública. O EIP standby deve estar vinculado ao gateway NAT. Após a criação da entrada DNAT, o EIP standby entra em vigor.	101.XXX.XXX.4

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Esquema da resposta.
RequestId	string	O ID da solicitação.	EF6D6FA4-DACA-5822-A981-81006271D263
ForwardEntryId	string	O ID da entrada DNAT.	fwd-5tc07cw14metghn3siv4a****

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "EF6D6FA4-DACA-5822-A981-81006271D263",
  "ForwardEntryId": "fwd-5tc07cw14metghn3siv4a****"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro
400	Invalid%s	The specified parameter %s is invalid.
400	Missing%s	You must specify the parameter %s.
400	InvalidParameter.NatNotFound	The specified Nat is not found.
400	InvalidParameter.ExternalIp	The specified externalIp is not found.
400	Forbidden.ExternalIpUsedInSnat	Forbidden.ExternalIpUsedInSnat
400	InvalidParameter.InternalIpNotFound	The input parameter internalIp that is not found.
400	Forbidden.ExternalPort.Duplicated	The specified ExternalPort is duplicated.
400	ForwardEntryLimitExceed	The limit of forward entry in the nat reaches.
400	InvalidParameter.HealthCheckPort	HealthCheckPort is not in the range of InternalPort
400	IncorrectInstanceStatus	The current status of the instance does not support this operation.
400	SystemBusy	System is busy, please try again later.
400	InvalidParameter.InternalIp	The specified parameter internalIp is invalid.
400	InvalidPort.Malformed	The specified port is not a valid port.
400	ens.interface.error	Failed to call API.
400	NoPermission	Permission denied.
400	InvalidParameter.%s	The specified field %s invalid. Please check it again.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.