ModifyNatGatewayAttribute - NAT Gateway - Centre de documentation Alibaba Cloud

Modifie le nom et la description d'une passerelle NAT.

Description de l'opération

Description\n\nVous pouvez appeler cette opération pour interroger une passerelle NAT Internet ou une passerelle NAT de réseau privé virtuel (VPC). Le terme passerelle NAT dans cette rubrique fait référence aux deux types de passerelles NAT.

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

update

*NatGateway

acs:vpc:{#regionId}:{#accountId}:natgateway/{#NatGatewayId}

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.\n\nVous pouvez appeler l'opération DescribeRegions pour consulter la liste des régions la plus récente.	cn-hangzhou
NatGatewayId	string	Oui	L'identifiant de la passerelle NAT.	ngw-2ze0dcn4mq31qx2jc****
Name	string	Non	Le nom de la passerelle NAT.\n\nLe nom doit comporter de 1 à 128 caractères et ne peut pas commencer par `http://` ou `https://`.	nat123
Description	string	Non	La description de la passerelle NAT.\n\nLa description doit comporter de 1 à 128 caractères et ne peut pas commencer par `http://` ou `https://`.	Description
IcmpReplyEnabled	boolean	Non	Indique si la fonctionnalité de non-récupération du protocole ICMP (Internet Control Message Protocol) doit être activée. Valeurs valides :\n\n* false (par défaut)\n* true	true
EipBindMode	string	Non	Modifie le mode d'association de l'EIP à la passerelle NAT. La valeur peut être vide ou NAT, ce qui spécifie le mode NAT.\n\n> \n\n* Vous pouvez uniquement changer MULTI_BINDED en NAT. Vous ne pouvez pas changer NAT en MULTI_BINDED. Pour plus d'informations sur le mode MULTI_BINDED, consultez CreateNatGateway.\n\n* Lorsque vous modifiez le mode d'association, votre réseau peut être interrompu pendant quelques secondes. La durée augmente avec le nombre d'EIP. Vous pouvez modifier le mode d'association pour 5 EIP au maximum en même temps. Nous vous recommandons de modifier le mode d'association pendant les heures creuses.\n* Une fois le mode d'association changé en NAT, la passerelle NAT Internet est compatible avec une passerelle IPv4. Si une EIP est associée à une 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 d'adresses IP privées suffisantes pour que les EIP soient associées à la passerelle NAT.	NAT
EnableSessionLog	boolean	Non	Indique si la journalisation des sessions doit être activée. Valeurs valides :\n- true : la journalisation des sessions est activée. \n- false : la journalisation des sessions est désactivée.	true
LogDelivery	object	Non	Informations de configuration du journal de session.
LogDeliveryType	string	Non	Type d'écriture du journal de session. Valeur : sls, Alibaba Cloud Log Service SLS.	sls
LogDestination	string	Non	Adresse d'écriture du journal de session. Valeur : acs:log:${regionName}:${projectOwnerAliUid}:project/${projectName}/logstore/${logstoreName}	acs:log:cn-hangzhou:0000:project/nat_session_log_project/logstore/session_log_test

É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.	AB5F62CF-2B60-4458-A756-42C9DFE108D1

Exemples

JSON format

{
  "RequestId": "AB5F62CF-2B60-4458-A756-42C9DFE108D1"
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	UnsupportedFeature.PrivateLinkMode	The feature of %s is not supported.	The feature of reverse access is not supported.
400	IncorrectStatus.NATGW	NATGW status is invalid.	The NAT gateway is in an invalid state.
400	ExclusiveParam.%sAnd%s	The param of %s and %s are mutually exclusive.	You cannot specify %s and %s at the same time.
400	IncorrectStatus.NatGateway	The status of natgateway is incorrect.	The status of the NAT gateway is invalid.
400	DependencyViolation.PrivateLinkMode	The specified resource of %s depends on %s, so the operation cannot be completed.	The %s resource depends on %s.
400	UnsupportedFeature.IcmpReplyEnabled	The feature of IcmpReplyEnabled is not supported.	The value of IcmpReplyEnabled cannot be modified.
400	InvalidParams.NotNull	The parameter must not be null, name or description or icmpReplyEnabled	The name, description, and ICMP proxy cannot be empty at the same time.
400	InvalidParameter.Name.Malformed	The specified Name is not valid.
400	InvalidParameter.Description.Malformed	The specified Description is not valid.
400	UnsupportedFeature.IndirectConvertForVpcNat	The VPC NAT gateway is not support to change EIP bond type.	The error message returned because the value of the EipBindMode parameter cannot be modified for a VPC NAT gateway.
400	UnsupportedFeature.NormalNatModifyEipBindMode	The normal NAT gateway is not support to change EIP bond type.	The value of EipBindMode cannot be modified for a standard NAT gateway.
400	OperationDenied.EipBondTypeIsAlreadyNAT	The EIP bond type is already NAT type.	EipBindMode is already set to NAT.
400	UnsupportedFeature.IndirectConvertForFwNat	The security protection enabled NAT gateway is not support change EIP bond type.	The value of EipBindMode cannot be modified for an Internet NAT gateway for which the security protection feature is enabled.
400	QuotaExceeded.EipNumForModifyEipBondType	The quota of %s is exceeded, binded: %s, quota: %s.	The number of allowed EIPs reaches the upper limit when you modify the EIP association type.
400	ResourceNotEnough.SwitchAvailableIps	The available private Ip number is not enough in your subnet.	The number of private IP addresses in the subnet is insufficient.
400	UnsupportedFeature.VpcNatSecurityProtectionEnabled	The VPC NAT gateway is not supported to enable security protection.	You cannot enable security protection for the VPC NAT gateway.
400	OperationDenied.NatGatewayStatusInvalid	The NAT gateway status is invalid.	The status of the NAT gateway does not support the operation.
400	OperationDenied.EipStatusInvalid	The NAT gateway has EIP in invalid status.	The EIP associated with the NAT gateway is in an invalid state.
400	OperationDenied.SnatEntryStatusInvalid	The NAT gateway has SNAT entry in invalid status.	The SNAT entry associated with the NAT gateway is in an invalid state.
400	OperationDenied.DnatEntryStatusInvalid	The NAT gateway has DNAT entry in invalid status.	The DNAT entry associated with the NAT gateway is in an invalid state.
400	UnsupportedFeature.MutilBindedTypeNatEnableFw	The NAT with Mutil-Binded Eip bind type is not support enable firewall.	You cannot enable firewall for the NAT gateway because EIPs are associated with the NAT gateway in Multi-Binded mode.
400	Forbidden.FinancialLocked	The instance is locked due to outstanding payments.	The instance has overdue payments.
400	OperationFailed.PrivateLinkMode	The NAT gateway is not support to change PrivateLinkMode.	The NAT gateway is not support to change PrivateLinkMode.
400	IllegalParam.SessionLogDeliveryDestination	The specified Delivery Destination is illegal.	The specified Delivery Destination(SessionLogDeliveryDestination) is illegal.
400	OperationFailed.LogDeliveryIsUnAuthorized	Operation failed because the user is not authorized to deliver NAT session log.	The operation failed because you did not grant the NAT session log delivery permission
400	IllegalParam.SessionLogDeliveryType	The specified Delivery Type is illegal.	The specified delivery type parameter SessionLogDeliveryType is illegal.
400	UnsupportedFeature.EnableSessionLog	The feature of EnableSessionLog is not supported.	This instance does not support opening NAT Gateway session logs.
500	OperationFailed.ConfigSessionLog	Failed to configure session log due to a temporary failure of the server.	Failed to configure session log due to an internal service error.
403	Forbidden.ModifyEipBondType	Authentication is failed for modify EIP bond type.	The value of EipBindMode cannot be modified.
404	InvalidRegionId.NotFound	The specified RegionId does not exist in our records.
404	InvalidNatGatewayId.NotFound	The specified NatGatewayId does not exist in our records.

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

Notes de version

Consultez Notes de version pour la liste complète.