Todos los productos
Search
Centro de documentos

ENS:ModifyForwardEntry

Última actualización: Sep 01, 2026

Modifica una regla de traducción de direcciones de red de destino (DNAT).

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

  • Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.

  • API: La API que debe invocarse para llevar a cabo la acción.

  • Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.

  • Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.

    • En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.

    • Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.

  • Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.

  • Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

ens:ModifyForwardEntry

update

*All Resource

*

Ninguna Ninguna

Parámetros de la solicitud

Parámetro

Tipo

Obligatorio

Descripción

Ejemplo

ForwardEntryId

string

Sí

El ID de la entrada DNAT.

dnat-5tfjp3537mi6iokl59g5c****

ForwardEntryName

string

No

El nombre de la entrada DNAT. El nombre debe tener entre 2 y 128 caracteres de longitud. No puede comenzar con http:// o https://.

test0

HealthCheckPort

integer

No

El puerto de sondeo. El puerto debe estar dentro del rango de puertos internos. De forma predeterminada, este parámetro se deja vacío.

80

ExternalIp

string

No

La EIP en la entrada DNAT. La dirección IP pública se utiliza para acceder a Internet.

121.XXX.XXX.28

ExternalPort

string

No

El puerto externo o rango de puertos que se utiliza para el reenvío de puertos.

  • Valores válidos: 1 a 65535.

  • Para especificar un rango de puertos, separe el primer puerto y el último puerto con una barra diagonal (/), como 10/20. Se incluyen tanto el primer puerto como el último.

  • Si configura ExternalPort como un rango de puertos, también debe configurar InternalPort como un rango de puertos. El número de puertos en los rangos debe ser el mismo. Por ejemplo, si configura ExternalPort como 10/20, puede configurar InternalPort como 80/90.

  • El rango máximo de puertos es 1000.

22

InternalIp

string

No

La dirección IP privada de la instancia que utiliza la entrada DNAT para la comunicación por Internet.

10.XXX.XXX.50

InternalPort

string

No

El puerto privado o rango de puertos que se utiliza en el reenvío de puertos.

  • Valores válidos: 1 a 65535.

  • Para especificar un rango de puertos, separe el primer puerto y el último puerto con una barra diagonal (/), como 10/20. Se incluyen tanto el primer puerto como el último.

  • Si configura InternalPort como un rango de puertos, también debe configurar ExternalPort como un rango de puertos. El número de puertos en los rangos debe ser el mismo. Por ejemplo, si configura ExternalPort como 10/20, puede configurar InternalPort como 80/90.

  • El rango máximo de puertos es 1000.

22

IpProtocol

string

No

El protocolo. Valores válidos:

  • TCP: reenvía paquetes TCP.

  • UDP: reenvía paquetes UDP.

  • Any (predeterminado): reenvía todos los paquetes.

Valores válidos:

  • TCP :

    TCP 协议

  • UDP :

    UDP 协议

  • Any :

    全部协议

Any

Elementos de la respuesta

Elemento

Tipo

Descripción

Ejemplo

object

Esquema de la respuesta.

RequestId

string

El ID de la solicitud.

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

Códigos de error

Código de estado HTTP

Código de error

Mensaje de error

Descripción

400 Missing%s You must specify the parameter %s.
400 Invalid%s The specified parameter %s is invalid.
400 ens.interface.error Failed to call API.
400 InvalidParameter.DnatNotFound The specified dnat is not found. The specified DNAT rule does not exist.
400 IncorretDnatEntryStatus Dnat entry status blocked this operation. Dnat status is incorrect, please check Dnat status.
400 InstanceNotFound Instance not found, please check the InstanceId. Instance not found, please check the instance ID
400 IncorrectInstanceStatus The current status of the instance does not support this operation. The instance is in a state that does not support the current operation.
400 Forbidden.ExternalPort.Duplicated The specified ExternalPort is duplicated. A DNAT rule has been configured for the external port. Do not repeat the configuration.
400 InvalidExternalIp.NotFound Specified ExternalIp does not found on the NAT Gateway. The public IP address is not in the NAT Gateway.
400 InvalidPort.Malformed The specified ExternalPort or InternalPort is not a valid port. The external or internal network port is incorrect.
400 Forbidden.ExternalIpUsedInSnat The external ip is already in use in the snat rule. The public IP address is already used in the SNAT rule. Please check.
400 InvalidParameter.HealthCheckPort HealthCheckPort is not in the range of InternalPort. The health check port is not in the intranet port range.
400 NoPermission Permission denied.
400 InvalidParameter.%s The specified field %s invalid. Please check it again.

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.