Todos os produtos
Search
Central de documentação

NAT Gateway:ModifyNatGatewayAttribute

Última atualização: Jun 29, 2026

Modifica o nome e a descrição de um gateway NAT.

Descrição da operação

Descrição

Você pode chamar esta operação para consultar um gateway NAT da Internet ou um gateway NAT de nuvem privada virtual (VPC). O termo gateway NAT neste tópico refere-se a ambos os tipos de gateway NAT.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

RegionId

string

Sim

O ID da região do gateway NAT.

Você pode chamar a operação DescribeRegions para consultar a lista de regiões mais recente.

cn-hangzhou

NatGatewayId

string

Sim

O ID do gateway NAT.

ngw-2ze0dcn4mq31qx2jc****

Name

string

Não

O nome do gateway NAT.

O nome deve ter de 1 a 128 caracteres e não pode começar com http:// ou https://.

nat123

Description

string

Não

A descrição do gateway NAT.

A descrição deve ter de 1 a 128 caracteres e não pode começar com http:// ou https://.

Description

IcmpReplyEnabled

boolean

Não

Especifica se o recurso de não recuperação do Internet Control Message Protocol (ICMP) deve ser ativado. Valores válidos:

  • false (padrão)

  • true

true

EipBindMode

string

Não

Modifica o modo como o EIP é associado ao gateway NAT. O valor pode estar vazio ou ser NAT, que especifica o modo NAT.

Nota
  • Você só pode alterar de MULTI_BINDED para NAT. Não é possível alterar de NAT para MULTI_BINDED. Para obter mais informações sobre o modo MULTI_BINDED, consulte CreateNatGateway.

  • Ao alterar o modo de associação, sua rede pode ser interrompida por alguns segundos. A duração aumenta com o número de EIPs. Você pode alterar o modo de associação para no máximo 5 EIPs ao mesmo tempo. Recomendamos alterar o modo de associação durante horários de menor pico.

  • Após o modo de associação ser alterado para NAT, o gateway NAT da Internet torna-se compatível com um gateway IPv4. Se um EIP estiver associado a um gateway NAT no modo NAT, o EIP ocupará um endereço IP privado do vSwitch ao qual o gateway NAT pertence. Certifique-se de que o vSwitch tenha endereços IP privados suficientes para que os EIPs sejam associados ao gateway NAT.

NAT

EnableSessionLog

boolean

Não

Especifica se o registro de sessões deve ser ativado. Valores válidos:

  • true: O registro de sessões está ativado.

  • false: O registro de sessões está desativado.

true

LogDelivery

object

Não

Informações de configuração do log de sessões.

LogDeliveryType

string

Não

Tipo de gravação do log de sessões. Valor: sls, Alibaba Cloud Log Service SLS.

sls

LogDestination

string

Não

Endereço de gravação do log de sessões. Valor: acs:log:${regionName}:${projectOwnerAliUid}:project/${projectName}/logstore/${logstoreName}

acs:log:cn-hangzhou:0000:project/nat_session_log_project/logstore/session_log_test

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

O ID da solicitação.

RequestId

string

O ID da solicitação.

AB5F62CF-2B60-4458-A756-42C9DFE108D1

Exemplos

Resposta de sucesso

JSON formato

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

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

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.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.