CreateForwardEntry - NAT Gateway - Centre de documentation Alibaba Cloud

Ajoute une entrée DNAT à une table DNAT.

Description de l'opération

Chaque entrée DNAT se compose des paramètres suivants : ExternalIp, ExternalPort, IpProtocol, InternalIp et InternalPort. Après avoir ajouté une entrée DNAT, la passerelle NAT transfère les paquets via le protocole spécifié de ExternalIp:ExternalPort vers InternalIp:InternalPort et renvoie les réponses par la même route.

Lorsque vous appelez cette opération, prenez note des limites suivantes :

CreateForwardEntry est une opération asynchrone. Après l'envoi d'une requête, le système renvoie un identifiant de requête et exécute la tâche en arrière-plan. Vous pouvez appeler l'opération DescribeForwardTableEntries pour interroger l'état de la tâche.
- Si l'entrée DNAT est dans l'état Pending, le système est en train d'ajouter l'entrée DNAT. Vous pouvez uniquement interroger l'entrée DNAT, mais vous ne pouvez pas effectuer d'autres opérations.
- Si l'entrée DNAT est dans l'état Available, l'entrée DNAT est ajoutée.
Vous ne pouvez pas appeler de manière répétée l'opération CreateForwardEntry pour ajouter une entrée DNAT dans un laps de temps spécifique.
Toutes les combinaisons de ExternalIp, ExternalPort et IpProtocol utilisées dans les entrées DNAT doivent être uniques. Vous ne pouvez pas distribuer des requêtes à plusieurs instances Elastic Compute Service (ECS) si ces requêtes sont initiées à partir de la même adresse IP source, reçues sur le même port et utilisent le même protocole.
Les combinaisons de IpProtocol, InternalIp et InternalPort doivent être uniques.
Si une ou plusieurs entrées DNAT dans la table DNAT sont dans l'état Pending ou Modifying, vous ne pouvez pas ajouter d'entrées DNAT à la table DNAT.
Vous pouvez ajouter au maximum 100 entrées DNAT à une table DNAT.
Pour une adresse IP élastique (EIP) utilisée par une passerelle NAT Internet ou une adresse IP NAT utilisée par une passerelle NAT de réseau privé virtuel (VPC), prenez note de la limite suivante : si l'adresse IP a le mappage IP activé et est spécifiée dans une entrée DNAT, l'adresse IP ne peut pas être utilisée par une autre entrée DNAT ou SNAT.

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:CreateForwardEntry

create

*ForwardTable

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

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
RegionId	string	Oui	L'identifiant de la région de la passerelle NAT. Vous pouvez appeler l'opération DescribeRegions pour obtenir l'identifiant de la région.	cn-hangzhou
ForwardTableId	string	Oui	L'identifiant de la table DNAT.	ftb-bp1mbjubq34hlcqpa****
ExternalIp	string	Oui	L'EIP accessible via Internet lorsque vous configurez une entrée DNAT pour une passerelle NAT Internet. L'adresse IP NAT accessible par les réseaux externes lorsque vous configurez une entrée DNAT pour une passerelle NAT VPC.	116.28.XX.XX
ExternalPort	string	Oui	La plage de ports externes utilisée pour le transfert de port lorsque vous configurez une entrée DNAT pour une passerelle NAT Internet. Valeurs valides : 1 à 65535. Pour spécifier une plage de ports, séparez le premier port et le dernier port par une barre oblique (/), par exemple, `10/20`. Si vous définissez ExternalPort sur une plage de ports, vous devez également définir InternalPort sur une plage de ports, et le nombre de ports spécifié par ces paramètres doit être identique. Par exemple, si vous définissez ExternalPort sur `10/20`, vous pouvez définir InternalPort sur `80/90`. Le port accessible par les réseaux externes lorsque vous configurez une entrée DNAT pour une passerelle NAT VPC. Valeurs valides : 1 à 65535.	8080
InternalIp	string	Oui	L'adresse IP privée de l'instance ECS qui doit communiquer avec Internet lorsque vous configurez une entrée DNAT pour une passerelle NAT Internet. L'adresse IP privée doit répondre aux exigences suivantes : Elle doit appartenir au bloc CIDR du VPC où la passerelle NAT est déployée. L'entrée DNAT ne prend effet que si l'adresse IP privée est attribuée à une instance ECS et que l'instance ECS n'est pas associée à une EIP. L'adresse IP privée qui utilise DNAT lorsque vous ajoutez une entrée DNAT à une passerelle NAT VPC.	192.168.XX.XX
InternalPort	string	Oui	Le port interne ou la plage de ports utilisée pour le transfert de port lorsque vous configurez une entrée DNAT pour une passerelle NAT Internet. Valeurs valides : 1 à 65535. Le port de l'instance ECS de destination à mapper lorsque vous configurez une entrée DNAT pour une passerelle NAT VPC. Valeurs valides : 1 à 65535.	80
IpProtocol	string	Oui	Le protocole. Valeurs valides : TCP UDP Any Si vous définissez IpProtocol sur Any, vous devez également définir ExternalPort et InternalPort sur Any pour implémenter le mappage IP DNAT.	TCP
ForwardEntryName	string	Non	Le nom de l'entrée DNAT. Le nom doit comporter de 2 à 128 caractères. Il doit commencer par une lettre, mais ne peut pas commencer par `http://` ou `https://`.	ForwardEntry-1
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 parmi les différentes requêtes. 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 l'identifiant de requête comme jeton client. L'identifiant de requête peut être différent pour chaque requête.	0c593ea1-3bea-11e9-b96b-88e9fe6****
PortBreak	boolean	Non	Indique si le franchissement de port doit être activé. Valeurs : true : active le franchissement de port. false (par défaut) : n'active pas le franchissement de port. Remarque Lorsque les entrées DNAT et SNAT utilisent la même adresse IP publique, si vous devez configurer un numéro de port supérieur à 1024, vous devez définir PortBreak sur true.	false
DryRun	boolean	Non	Indique si un test à blanc de la requête doit être effectué. Valeurs : true : envoie une requête de vérification sans créer d'entrée DNAT. Les vérifications incluent la validité de l'AccessKey, l'état d'autorisation de l'utilisateur RAM et si tous les paramètres requis sont renseignés. Si une vérification échoue, l'erreur correspondante est renvoyée. Si toutes les vérifications réussissent, le code d'erreur `DryRunOperation` est renvoyé. false (par défaut) : envoie une requête normale. Après avoir réussi les vérifications, elle renvoie un code d'état HTTP 2xx et crée une entrée DNAT.	false

Éléments de réponse

Élément	Type	Description	Exemple
	object
ForwardEntryId	string	L'identifiant de l'entrée DNAT.	fwd-119smw5tkasdf****
RequestId	string	L'identifiant de la requête.	A4AEE536-A97A-40EB-9EBE-53A6948A6928

Exemples

JSON format

{
  "ForwardEntryId": "fwd-119smw5tkasdf****",
  "RequestId": "A4AEE536-A97A-40EB-9EBE-53A6948A6928"
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	UnsupportedFeature.PrivateLinkEnabled	The feature of PrivateLinkEnabled is not supported.
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	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	InvalidIp.NotInNatgw	The specified Ip not belong to natgateway.
400	QuotaExceeded.ForwardEntry	The quota of %s is exceeded, usage %s/%s.
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	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 Internal Ip is Out of VPC CIDR.
400	Forbidden.DestinationIpOutOfVswitchCIDR	The specified Internal Ip is Out of VSwitch CIDR.
400	InvalidProtocal.ValueNotSupported	The specified IpProtocol does not support.
400	IncorretForwardEntryStatus	Some Forward entry status blocked this operation..
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	Forbindden	The specified Instance already bind eip
400	Forbidden.InternalIpOutOfVpcCIDR	The specified Internal Ip is Out of VPC CIDR.
400	Invalid.natgwNotExist	The specified natgateway not exist.
400	MissingParameter	Missing mandatory parameter
400	AnyPort.PortMustBeZero	any port port must be zero.
400	InvalidParameter.Name.Malformed	The specified Name is not valid.
400	IncorrectStatus.ForwardEntry	The status of %s [%s] is incorrect.	The DNAT entry to be deleted is in an invalid state.
400	Duplicated.DestinationPort	The specified param DestinationPort is duplicated.
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	TaskConflict	The operation is too frequent, please wait a moment and try again.	Your requests are too frequent. Try again later.
400	OperationFailed.DnatPortRangeLimit	The maximum number of port ranges that can be specified is exceeded.	The maximum number of port ranges that can be specified is exceeded.
400	IncorrectStatus.NATGW	NATGW status is invalid.	The NAT gateway is in an invalid state.
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.
500	System.Error	ERROR SYSTEM ERROR.
500	InternalError	The request processing has failed due to some unknown error.
404	ResourceNotFound.NatIp	The specified resource of %s is not found.
404	InvalidRegionId.NotFound	The specified RegionId does not exist in our records.
404	InvalidForwardTableId.NotFound	Specified forward table does not exist.
404	InvalidExternalIp.NotFound	Specified External Ip address does not found on the VRouter

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

Notes de version

Consultez Notes de version pour la liste complète.