CreateNatGateway - - Centre de documentation Alibaba Cloud

Notes d'utilisation

Avant d'appeler cette opération, tenez compte des points suivants :

Lors de la première création d'une passerelle NAT améliorée, le système crée automatiquement le rôle lié au service AliyunServiceRoleForNatgw. Il associe ensuite la stratégie d'autorisation AliyunServiceRolePolicyForNatgw à ce rôle. Cela permet à la passerelle NAT d'accéder aux autres ressources sur Alibaba Cloud. Pour plus d'informations, consultez Rôles liés au service.
Après la création d'une passerelle NAT Internet améliorée, une entrée de route est automatiquement ajoutée à la table de routage du VPC. Le bloc CIDR de destination de cette entrée est 0.0.0.0/0 et le saut suivant est la passerelle NAT. Cela garantit que le trafic est acheminé vers la passerelle NAT.
CreateNatGateway est une opération asynchrone. Une fois la requête envoyée, le système renvoie un ID de requête et exécute la tâche en arrière-plan. Appelez l'opération DescribeNatGateways pour interroger l'état de la tâche.
- Si une passerelle NAT est dans l'état Creating, elle est en cours de création. Dans ce cas, vous pouvez interroger la passerelle NAT, mais vous ne pouvez pas effectuer d'autres opérations.
- Si une passerelle NAT est dans l'état Available, elle a été créée.
  
  La création d'une passerelle NAT prend entre 1 et 3 minutes.
Vous ne pouvez pas appeler l'opération CreateNatGateway de manière répétée dans un délai spécifique.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour votre commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement l'exemple de code de l'opération pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	CreateNatGateway	L'opération à effectuer. Définissez la valeur sur CreateNatGateway.
RegionId	String	Yes	cn-hangzhou	L'ID de la région où créer la passerelle NAT. Appelez l'opération DescribeRegions pour obtenir la liste des régions la plus récente.
VpcId	String	Yes	vpc-bp1di7uewzmtvfuq8****	L'ID du VPC où créer la passerelle NAT.
Name	String	No	fortest	Le nom de la passerelle NAT. Le nom doit comporter entre 2 et 128 caractères et peut contenir des lettres, des chiffres, des traits de soulignement (_) et des traits d'union (-). Le nom doit commencer par une lettre. Si ce paramètre n'est pas défini, le système attribue un nom par défaut à la passerelle NAT.
Description	String	No	testnat	La description de la passerelle NAT. Vous pouvez laisser ce paramètre vide ou saisir une description. Si vous saisissez une description, celle-ci doit comporter entre 2 et 256 caractères et ne peut pas commencer par `http://` ou `https://`.
ClientToken	String	No	5A2CFF0E-5718-45B5-9D4D-70B3FF3898	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 différentes requêtes. Remarque Si vous ne spécifiez pas ce paramètre, le système utilise automatiquement le client token comme request ID. L'request ID peut être différent pour chaque requête.
Spec	String	No	Invalid parameter.	Les passerelles NAT Internet par abonnement ne sont plus disponibles à l'achat. Ignorez ce paramètre.
InstanceChargeType	String	No	PostPaid	La méthode de facturation de la passerelle NAT. Définissez la valeur sur PostPaid (paiement à l'utilisation), qui est la valeur par défaut. Pour plus d'informations, consultez Facturation des passerelles NAT Internet et Facturation des passerelles NAT VPC.
PricingCycle	String	No	Invalid parameter.	Les passerelles NAT Internet par abonnement ne sont plus disponibles à l'achat. Ignorez ce paramètre.
Duration	String	No	Invalid parameter.	Les passerelles NAT Internet par abonnement ne sont plus disponibles à l'achat. Ignorez ce paramètre.
AutoPay	Boolean	No	Invalid parameter.	Les passerelles NAT Internet par abonnement ne sont plus disponibles à l'achat. Ignorez ce paramètre.
VSwitchId	String	Yes	vsw-bp1e3se98n9fq8hle****	L'ID du vSwitch auquel la passerelle NAT est attachée. Lorsque vous créez une passerelle NAT, vous devez spécifier un vSwitch pour celle-ci. Le système attribue alors une adresse IP privée inutilisée du vSwitch à la passerelle NAT. Pour attacher la passerelle NAT à un vSwitch existant, assurez-vous que la zone à laquelle appartient le vSwitch prend en charge les passerelles NAT. De plus, le vSwitch doit disposer d'adresses IP inutilisées. Si aucun vSwitch n'existe dans le VPC, créez un vSwitch dans une zone qui prend en charge les passerelles NAT. Spécifiez ensuite ce vSwitch pour la passerelle NAT. Remarque Interrogez les zones qui prennent en charge les passerelles NAT en appelant l'opération ListEnhanhcedNatGatewayAvailableZones. Interrogez le nombre d'adresses IP disponibles dans un vSwitch en appelant l'opération DescribeVSwitches.
NatType	String	Yes	Enhanced	Le type de passerelle NAT. Définissez la valeur sur Enhanced (passerelle NAT améliorée).
InternetChargeType	String	No	PayByLcu	La méthode de comptage de la passerelle NAT. Définissez la valeur sur PayByLcu, qui spécifie la méthode de comptage par CU.
NetworkType	String	No	internet	Le type de réseau de la passerelle NAT. Valeurs valides : internet : Internet intranet : VPC
SecurityProtectionEnabled	Boolean	No	false	Indique si la fonctionnalité de pare-feu est activée. Valeurs valides : false (par défaut) true
IcmpReplyEnabled	Boolean	No	true	Indique si la récupération ICMP est activée. Valeurs valides : true (par défaut) false
EipBindMode	String	No	MULTI_BINDED	Le mode d'association de l'EIP à la passerelle NAT. Valeurs valides : MULTI_BINDED (par défaut) : Mode Multi-EIP-to-ENI. NAT : Mode NAT. Les passerelles IPv4 sont prises en charge. Remarque Si l'EIP est associée à la passerelle NAT en mode NAT, l'EIP occupe une adresse IP privée du vSwitch auquel appartient la passerelle NAT. Assurez-vous que le vSwitch dispose de suffisamment d'adresses IP privées. Sinon, l'EIP ne peut pas être associée à la passerelle NAT. En mode NAT, vous pouvez associer au maximum 50 EIP à une passerelle NAT.
Tag.N.Key	String	No	TestKey	La clé du tag. Le format de Tag.N.Key lors de l'appel de l'opération. Valeurs valides de N : 1 à 20. Ne peut pas être une chaîne vide. Peut comporter jusqu'à 128 caractères et ne peut pas commencer par acs: ou aliyun. Ne peut pas contenir http:// ou https://.
Tag.N.Value	String	No	TestValue	La valeur du tag. Le format de Tag.N.Value lors de l'appel de l'opération. Valeurs valides de N : 1 à 20. Ne peut pas être une chaîne vide. Peut comporter jusqu'à 128 caractères et ne peut pas commencer par acs: ou aliyun. Ne peut pas contenir http:// ou https://.

Paramètres de réponse

Parameter	Type	Example	Description
NatGatewayId	String	ngw-112za33e4****	L'ID de la passerelle NAT.
RequestId	String	2315DEB7-5E92-423A-91F7-4C1EC9AD97C3	L'ID de la requête.
ForwardTableIds	Array of String	ftb-11tc6xgmv****	La liste des entrées DNAT.
SnatTableIds	Array of String	stb-SnatTableIds****	La liste des entrées SNAT.
FullNatTableIds	Array of String	fulltb-gw88z7hhlv43rmb26****	La liste des entrées FULLNAT.

Exemples

Exemples de requêtes

http(s)://[Endpoint]/?Action=CreateNatGateway
&RegionId=cn-hangzhou
&VpcId=vpc-bp1di7uewzmtvfuq8****
&Name=fortest
&Description=testnat
&ClientToken=5A2CFF0E-5718-45B5-9D4D-70B3FF3898
&Spec=Invalid parameter
&InstanceChargeType=PostPaid
&PricingCycle=Invalid parameter
&Duration=Invalid parameter
&AutoPay=false
&VSwitchId=vsw-bp1e3se98n9fq8hle****
&NatType=Enhanced
&InternetChargeType=PayByLcu
&NetworkType=internet
&SecurityProtectionEnabled=false
&IcmpReplyEnabled=true
&EipBindMode=MULTI_BINDED
&Tag=[{"Key":"TestKey","Value":"TestValue"}]
&Common request parameters

Exemples de réponses réussies

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateNatGatewayResponse>
    <NatGatewayId>ngw-112za33e4****</NatGatewayId>
    <RequestId>2315DEB7-5E92-423A-91F7-4C1EC9AD97C3</RequestId>
    <ForwardTableIds>ftb-11tc6xgmv****</ForwardTableIds>
    <SnatTableIds>stb-SnatTableIds****</SnatTableIds>
    <FullNatTableIds>fulltb-gw88z7hhlv43rmb26****</FullNatTableIds>
</CreateNatGatewayResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "NatGatewayId" : "ngw-112za33e4****",
  "RequestId" : "2315DEB7-5E92-423A-91F7-4C1EC9AD97C3",
  "ForwardTableIds" : [ "ftb-11tc6xgmv****" ],
  "SnatTableIds" : [ "stb-SnatTableIds****" ],
  "FullNatTableIds" : [ "fulltb-gw88z7hhlv43rmb26****" ]
}

Codes d'erreur

HttpCode	Error code	Error message	Description
400	Forbidden.NatPayBySpec	Pay-by-specification NAT is no longer supported. Newly purchased pay-as-you-go NAT gateways only support the pay-by-CU metering method.	Les passerelles NAT facturées selon les spécifications ne sont plus disponibles à l'achat. Définissez le paramètre InternetChargeType sur PayByLcu.
400	InvalidVPCStatus	vpc incorrect status.	L'opération n'est pas prise en charge lorsque le VPC est dans l'état actuel. Vérifiez si l'état du VPC est valide.
400	InvalidNatGatewayName.MalFormed	NatGateway name is not valid.	Le nom spécifié pour la passerelle NAT n'est pas valide.
400	InvalidNatGatewayDescription.MalFormed	NatGateway description is not valid.	La description de la passerelle n'est pas valide.
400	MissingParameter.BandwidthPackage	only support one BandwidthPackage be created with NatGateway.	Aucun plan de bande passante EIP n'est spécifié. Vous devez spécifier un plan de bande passante EIP.
400	MissingParameter	Miss mandatory parameter.	Un ou plusieurs paramètres requis ne sont pas définis. Vérifiez si vous avez défini tous les paramètres requis avant d'appeler cette opération.
400	QuotaExceeded.BandwidthPackageIps	The specified ipCount exceeded quota.	Le nombre d'adresses IP a atteint la limite supérieure. Demandez une augmentation du quota sur la page Gestion des quotas.
400	InvalidParameter.Name.Malformed	The specified Name is not valid.	Le format du nom spécifié n'est pas valide. Saisissez le nom dans un format valide.
400	InvalidParameter.Description.Malformed	The specified Description is not valid.	La description spécifiée n'est pas valide.
400	ZONE_NO_AVAILABLE_IP	The Zone have no available ip.	Aucune adresse IP n'est disponible dans la zone.
400	InvalidParameter.BandwidthPackage.n.ISP.ValueNotSupport	The specified ISP of BandwidthPackage is not valid.	Le fournisseur de services Internet (ISP) spécifié pour le plan de bande passante EIP n'est pas valide.
400	InvalidNatGatewayId.NotFound	The NatGatewayId not exist.	L'ID de passerelle NAT spécifié n'existe pas. Vérifiez si la valeur du paramètre NatGatewayId est valide.
400	VswitchStatusError	The VSwitch is creating .	L'opération n'est pas prise en charge lorsque le vSwitch est en cours de création.
400	VpcStatusError	The Vpc is creating .	L'opération n'est pas prise en charge lorsque le VPC est en cours de création.
400	InvalidParameter.Spec.ValueNotSupported	The specified Spec is not valid.	La taille spécifiée n'est pas valide.
400	TaskConflict	The operation is too frequent, TaskConflict.	Le système est occupé. Réessayez ultérieurement.
400	Forbidden.CheckEntryRuleQuota	Route entry quota rule check error.	Une erreur s'est produite lors de la vérification du quota des entrées de route.
400	OperationFailed.UnpaidBillsExist	The account has unpaid bills. Please pay your overdue bill first.	Le compte comporte des commandes impayées.
400	OperationFailed.RiskControl	Risk control check failed.	Des risques de sécurité sont détectés dans votre mode de paiement. Cliquez sur le lien dans l'e-mail qui vous a été envoyé ou dans la console ApsaraDB RDS pour poursuivre la vérification. Une fois la vérification terminée, soumettez à nouveau la commande.
400	OperationFailed.EnhancedQuotaExceed	Enhanced nat gateway per vpc quota is exceeded	Le nombre de passerelles NAT améliorées dans le VPC spécifié a atteint la limite supérieure.
400	OperationFailed.VswNotBelongToVpc	Operation failed because the specified VSwitch is not bound to the same VPC with NAT gateway.	Le vSwitch et la passerelle NAT n'appartiennent pas au même VPC.
400	OperationFailed.EnhancedUserIsUnAuthorized	Operation failed because the user is not authorized to create an enhanced NAT gateway.	Vous ne disposez pas des autorisations nécessaires pour créer des passerelles NAT améliorées.
400	OperationUnsupported.PrePaidPyByLcu	The operation failed because the subscription NAT gateway does not support the pay-by-LCU billing method.	Les passerelles NAT par abonnement ne prennent pas en charge la méthode de comptage par LCU.
400	OperationFailed.NormalInventoryNotEnough	Standard NAT gateways are no longer offered. You can create enhanced NAT gateways and set the correct natType.	Vous ne pouvez plus créer de passerelles NAT standard. Définissez le paramètre NatType sur Enhanced.
400	UnsupportedFeature.IcmpReplyEnabled	The feature of IcmpReplyEnabled is not supported.	La valeur du paramètre IcmpReplyEnabled ne peut pas être modifiée.
400	ExclusiveParam.%sAnd%s	The param of %s and %s are mutually exclusive.	Vous ne pouvez pas définir %s et %s en même temps.
400	SecurityGroupType.NotSupported	The specified security group type is not supported.	Le groupe de sécurité est déjà hébergé et ne peut pas être utilisé.
400	SecurityGroup.NotExist	The specified security group is not exist.	Le groupe de sécurité n'existe pas dans ce VPC.
404	InvalidRegionId.NotFound	The specified RegionId does not exist in our records.	L'ID de région spécifié n'existe pas.
404	InvalidVpcId.NotFound	Specified value of VpcId is not found in our record.	Le VPC spécifié n'existe pas. Vérifiez si l'ID de VPC spécifié est valide.
404	InvalidZoneId.NotFound	Specified value of ZoneId is not exists.	La zone spécifiée n'existe pas.
404	InvalidZoneId.NotFound	Can not find ZoneId for allocated ip.	La zone de l'adresse IP spécifiée n'est pas valide.
404	UnsupportedZoneForFwNat	The zone is unsupported for FW NAT.	La zone spécifiée ne prend pas en charge les passerelles NAT améliorées avec pare-feu activé.

Pour obtenir la liste des codes d'erreur, consultez les Codes d'erreur de service.