Tous les produits
Search
Centre de documentation

NAT Gateway:ModifyForwardEntry

Dernière mise à jour :Aug 18, 2026

Modifie une entrée DNAT spécifiée.

Description de l'opération

  • ModifyForwardEntry est une opération asynchrone. Après l'envoi d'une requête, le système renvoie un identifiant de requête, mais l'entrée DNAT n'a pas encore été modifiée. La tâche de modification s'exécute en arrière-plan. Vous pouvez appeler DescribeForwardTableEntries pour interroger l'état de l'entrée DNAT :

    • Si l'entrée DNAT est dans l'état Pending, l'entrée DNAT est en cours de modification. Dans cet état, vous pouvez uniquement effectuer des opérations de requête.

    • Si l'entrée DNAT est dans l'état Available, l'entrée DNAT est modifiée.

  • ModifyForwardEntry ne prend pas en charge les modifications simultanées d'une entrée DNAT au sein de la même table DNAT.

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.

vpc:ModifyForwardEntry

update

*ForwardTable

acs:vpc:{#regionId}:{#accountId}:forwardtable/{#ForwardTableId}

Aucune Aucune

Paramètres de requête

Paramètre

Type

Requis

Description

Exemple

ForwardTableId

string

Oui

L'identifiant de la table DNAT à laquelle l'entrée DNAT appartient.

ftb-8vbx8xu2lqj9qb334****

ForwardEntryId

string

Oui

L'identifiant de l'entrée DNAT à modifier.

fwd-8vbn3bc8roygjp0gy****

ExternalIp

string

Non

  • Si vous modifiez une entrée DNAT d'une passerelle NAT Internet, ce paramètre spécifie l'adresse IP publique utilisée pour fournir l'accès au réseau public.

  • Si vous modifiez une entrée DNAT d'une passerelle NAT VPC, ce paramètre spécifie l'adresse IP NAT accédée par le réseau externe.

116.85.XX.XX

ExternalPort

string

Non

  • Si vous modifiez une entrée DNAT d'une passerelle NAT Internet, ce paramètre spécifie le port externe ou la plage de ports utilisée pour la redirection de ports dans l'entrée DNAT.

    • La plage de ports doit être comprise entre 1 et 65535.

    • Pour spécifier une plage de ports, séparez les ports de début et de fin par une barre oblique (/), par exemple 10/20.

    • Si vous modifiez à la fois ExternalPort et InternalPort, et que ExternalPort est défini sur une plage de ports, InternalPort doit également être défini sur une plage de ports avec le même nombre de ports. Par exemple, si ExternalPort est défini sur 10/20, InternalPort doit être défini sur 80/90.

  • Si vous modifiez une entrée DNAT d'une passerelle NAT VPC, ce paramètre spécifie le port accédé par le réseau externe. Valeurs valides : 1 à 65535.

80

InternalIp

string

Non

  • Si vous modifiez une entrée DNAT d'une passerelle NAT Internet, ce paramètre spécifie l'adresse IP privée de l'instance ECS qui communique avec Internet via l'entrée DNAT.

  • Si vous modifiez une entrée DNAT d'une passerelle NAT VPC, ce paramètre spécifie l'adresse IP privée qui doit communiquer via la règle DNAT.

10.0.0.78

InternalPort

string

Non

  • Si vous modifiez une entrée DNAT d'une passerelle NAT Internet, ce paramètre spécifie le port interne ou la plage de ports utilisée pour la redirection de ports dans l'entrée DNAT. Valeurs valides : 1 à 65535.

  • Si vous modifiez une entrée DNAT d'une passerelle NAT VPC, ce paramètre spécifie le port de l'instance ECS de destination à mapper. Valeurs valides : 1 à 65535.

80

IpProtocol

string

Non

Le type de protocole. Valeurs valides :

  • TCP : transfère les paquets TCP.

  • UDP : transfère les paquets UDP.

  • Any : transfère les paquets de tous les protocoles.

TCP

ForwardEntryName

string

Non

Le nouveau nom de l'entrée DNAT.

Le nom doit comporter de 2 à 128 caractères et doit commencer par une lettre ou un caractère chinois. Il ne peut pas commencer par http:// ou https://.

test

RegionId

string

Oui

L'identifiant de la région de la passerelle NAT.

Vous pouvez appeler DescribeRegions pour interroger l'identifiant de la région.

cn-hangzhou

ClientToken

string

Non

Le jeton client utilisé pour garantir l'idempotence de la requête.

Vous pouvez utiliser le client pour générer le jeton, mais vous devez vous assurer que le jeton est unique pour chaque requête. Le jeton ne peut contenir que des caractères ASCII.

Remarque

Si vous ne spécifiez pas ce paramètre, le système utilise automatiquement le RequestId de la requête API comme ClientToken. Le RequestId peut être différent pour chaque requête API.

123e4567-e89b-12d3-a456-426655440000

PortBreak

boolean

Non

Indique si la rupture de port doit être activée. Valeurs valides :

  • true : active la rupture de port.

  • false : n'active pas la rupture de port. Si une entrée DNAT et une entrée SNAT utilisent la même adresse IP publique et que vous souhaitez configurer un numéro de port supérieur à 1024, définissez PortBreak sur true.

false

DryRun

boolean

Non

Indique si un test à blanc doit être effectué. Valeurs valides :

  • true : effectue un test à blanc sans modifier l'entrée DNAT. Le système vérifie les paramètres requis, le format de la requête et les limites du service. Si la requête échoue au test à blanc, un message d'erreur est renvoyé. Si la requête réussit le test à blanc, le code d'erreur DryRunOperation est renvoyé.

  • false (par défaut) : effectue un test à blanc et envoie la requête. Si la requête réussit le test à blanc, un code d'état HTTP 2xx est renvoyé et l'entrée DNAT est modifiée.

false

Éléments de réponse

Élément

Type

Description

Exemple

object

L'identifiant de la requête.

RequestId

string

L'identifiant de la requête.

2315DEB7-5E92-423A-91F7-4C1EC9AD97C3

Exemples

JSON format

{
  "RequestId": "2315DEB7-5E92-423A-91F7-4C1EC9AD97C3"
}

Codes d'erreur

Code de statut HTTP

Code d'erreur

Message d'erreur

Description

400 UnsupportedFeature.PortSegment The feature of PortSegment is not supported.
400 ExclusiveParam.%sAnd%s The param of %s and %s are mutually exclusive. You cannot specify %s and %s at the same time.
400 InvalidIp.NotInNatgw The specified Ip not belong to natgateway.
400 DuplicatedParam.InternalPort The param of %s is duplicated. Duplicate or occupied InternalPort parameter
400 DuplicatedParam.ExternalPort The param of %s is duplicated. The DNAT public network port has been used repeatedly.
400 OperationFailed.AnyPortConfig Operation failed because any port correspondence any protocol The operation failed. There is a conflict with another entry, any port or any protocol type.
400 OperationUnsupported.ForwardEntry Duplicated destination ip port is unsupported. You cannot specify duplicate destination IP addresses or destination ports.
400 IncorrectStatus.NatIp The status of %s [%s] is incorrect. The status of NatIp is incorrect.
400 Forbidden.IpHasBeenUsedInSnat The source ip can't be used. Because it has been used in snat.
400 IncorrectStatus.ForwardEntry The status of %s [%s] is incorrect. The DNAT entry to be deleted is in an invalid state.
400 InvalidExternalIp.Malformed The specified ExternalIp is not a valid IP address.
400 InvalidInternalIp.Malformed The specified InternalIp is not a valid IP address.
400 InvalidExternalPort.Malformed The specified ExternalPort is not a valid port.
400 InvalidInternalPort.Malformed The specified InternalPort is not a valid port.
400 Forbidden.DestnationIpOutOfVpcCIDR The specified Destination Ip is Out of VPC CIDR.
400 InvalidProtocal.ValueNotSupported The specified IpProtocol does not support.
400 IncorretForwardEntryStatus Some Forward entry status blocked this operation..
400 QuotaExceeded Forward entry quota exceeded in this route table. A route table can only have 200 custom route entries at most.
400 ForwardEntry.Duplicated The specified ExternalIp, IpProtocol, ExternalPort,InternalIp, InternalPort is duplicated
400 Forbidden.ExternalIp.UsedInSnatTable The specified ExternalIp is already used in SnatTable
400 Forbidden.Already.Bounded The specified instance already bounded
400 InvalidIp.NotFound The specified ip does not exist.
400 InvalidParameter.Name.Malformed The specified Name is not valid.
400 IncorretStatus.ForwardEntry The Specified forwardEntry is not stable status, can not operation
400 IllegalParam.AnyPortNotZero Any port port must be zero. You must set the destination port and source port to 0 when IpProtocol is set to Any.
400 Duplicated.DestinationPort The specified param DestinationPort is duplicated.
400 InvalidForwardEntryId.NotFound Specified forward entry ID does not exist
400 OperationUnsupported.EipInBinding Create snat entry with eip in associating status is unsupported. You cannot use an associated EIP when you create an SNAT entry.
400 QuotaExceeded.ForwardEntrySessionManytoOne The dnat session quota is exceed. The number of DNAT sessions exceeds the upper limit.
400 OperationFailed.ForwardEntryNotAllowSrcIpEqualDstIp The source IP of forward entry is not allowed to equal destination IP. The public IP address of the DNAT entry is not allowed to be equal to the private IP address.
404 ResourceNotFound.NatIp The specified resource of %s is not found.
404 ResourceNotFound.ForwardEntry The specified resource of %s is not found. The specified %s resource does not exist.
404 InvalidRegionId.NotFound The specified RegionId does not exist in our records.
404 InvalidForwardEntryId.NotFound Specified forward entry ID does not exist
404 InvalidExternalIp.NotFound Specified External Ip address does not found on the VRouter
404 InvalidForwardTableId.NotFound Specified forward table does not exist.

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

Notes de version

Consultez Notes de version pour la liste complète.