Todos os produtos
Search
Central de documentação

NAT Gateway:ModifyNatGatewayAttribute

Última atualização: Oct 15, 2026

Modifica os atributos de um gateway NAT.

Descrição da operação

Os gateways NAT compatíveis com esta operação incluem gateways NAT de Internet e gateways NAT de VPC. O termo "gateway NAT" neste documento refere-se a ambos os tipos sem distinção.

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 que você deseja modificar.

Você pode chamar a operação DescribeRegions para consultar os IDs de região.

cn-hangzhou

NatGatewayId

string

Sim

O ID do gateway NAT que você deseja modificar.

ngw-2ze0dcn4mq31qx2jc****

Name

string

Não

O nome do gateway NAT que você deseja modificar.

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 que você deseja modificar.

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 a resposta de eco ICMP deve ser ativada. Valores válidos:

  • true (padrão): ativa a resposta de eco ICMP.

  • false: desativa a resposta de eco ICMP.

true

EipBindMode

string

Não

O padrão de associação de EIP do gateway NAT. Valores válidos: Você pode deixar este parâmetro vazio. Se você especificar um valor, apenas NAT é permitido, o que indica o modo de associação de EIP padrão.

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

  • Durante o procedimento de alternância do padrão de associação de EIP, a conectividade de rede pode experimentar uma interrupção transitória na ordem de segundos (a duração da interrupção transitória aumenta com o número de EIPs. Atualmente, alterações de configuração são compatíveis com gateways NAT com até cinco EIPs associados), portanto, execute a operação de alternância durante horários de menor pico.

  • Depois que o padrão de associação de EIP for alterado para NAT, o gateway NAT de Internet se torna compatível com o gateway IPv4. No entanto, ao associar um EIP público, um endereço IP privado na vSwitch onde o gateway NAT reside é ocupado. Certifique-se de que a vSwitch tenha endereços IP privados suficientes. Se não houver nenhum endereço IP privado disponível na vSwitch, você não poderá associar um novo EIP.

Valores válidos:

  • NAT :

    Modo de EIP padrão.

NAT

EnableSessionLog

boolean

Não

Especifica se o recurso de log de sessão deve ser ativado. Valores válidos:

  • true: ativa o recurso de log de sessão.

  • false: desativa o recurso de log de sessão.

true

LogDelivery

object

Não

A configuração do log de sessão.

LogDeliveryType

string

Não

O tipo de entrega do log de sessão. Valores válidos: sls, que indica o Simple Log Service.

sls

LogDestination

string

Não

O destino de entrega do log de sessão. Valores válidos: 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. O recurso de acesso reverso não é suportado atualmente.
400 IncorrectStatus.NATGW NATGW status is invalid. O gateway NAT está em um estado anormal.
400 ExclusiveParam.%sAnd%s The param of %s and %s are mutually exclusive. Os parâmetros %s e %s são mutuamente exclusivos.
400 IncorrectStatus.NatGateway The status of natgateway is incorrect. O gateway NAT está em um estado inválido.
400 DependencyViolation.PrivateLinkMode The specified resource of %s depends on %s, so the operation cannot be completed. Existem recursos dependentes.
400 UnsupportedFeature.IcmpReplyEnabled The feature of IcmpReplyEnabled is not supported. A modificação do recurso de ativação de recuperação ICMP não é suportada.
400 InvalidParams.NotNull The parameter must not be null, name or description or icmpReplyEnabled O parâmetro não pode estar vazio.
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. Os gateways NAT da VPC não suportam a modificação do tipo de associação de EIP.
400 UnsupportedFeature.NormalNatModifyEipBindMode The normal NAT gateway is not support to change EIP bond type. Os gateways NAT padrão não suportam a modificação do tipo de associação de EIP.
400 OperationDenied.EipBondTypeIsAlreadyNAT The EIP bond type is already NAT type. O tipo de associação de EIP já está definido como NAT.
400 UnsupportedFeature.IndirectConvertForFwNat The security protection enabled NAT gateway is not support change EIP bond type. Os gateways NAT de Internet com proteção ativada não suportam a modificação do tipo de associação de EIP.
400 QuotaExceeded.EipNumForModifyEipBondType The quota of %s is exceeded, binded: %s, quota: %s. O número de EIPs excede o limite permitido ao modificar o tipo de associação de EIP.
400 ResourceNotEnough.SwitchAvailableIps The available private Ip number is not enough in your subnet. A sub-rede não possui endereços IP privados disponíveis suficientes.
400 UnsupportedFeature.VpcNatSecurityProtectionEnabled The VPC NAT gateway is not supported to enable security protection. Os gateways NAT da VPC não suportam a ativação da proteção de segurança.
400 OperationDenied.NatGatewayStatusInvalid The NAT gateway status is invalid. O status do gateway NAT é inválido.
400 OperationDenied.EipStatusInvalid The NAT gateway has EIP in invalid status. O status do EIP associado ao gateway NAT é inválido.
400 OperationDenied.SnatEntryStatusInvalid The NAT gateway has SNAT entry in invalid status. O status da entrada SNAT configurada para o gateway NAT é inválido.
400 OperationDenied.DnatEntryStatusInvalid The NAT gateway has DNAT entry in invalid status. O status da entrada DNAT configurada para o gateway NAT é inválido.
400 UnsupportedFeature.MutilBindedTypeNatEnableFw The NAT with Mutil-Binded Eip bind type is not support enable firewall. O firewall não pode ser ativado para gateways NAT com EIPs associados no modo Mutil-Binded.
400 Forbidden.FinancialLocked The instance is locked due to outstanding payments. A instância está bloqueada devido a um pagamento em atraso e não pode ser operada.
400 OperationFailed.PrivateLinkMode The NAT gateway is not support to change PrivateLinkMode. O parâmetro PrivateLinkMode não pode ser modificado para o gateway NAT atual.
400 IllegalParam.SessionLogDeliveryDestination The specified Delivery Destination is illegal. O formato do parâmetro SessionLogDeliveryDestination para o destino de entrega de log de sessão é inválido.
400 OperationFailed.LogDeliveryIsUnAuthorized Operation failed because the user is not authorized to deliver NAT session log. A operação falhou porque você não tem autorização para a entrega de logs de sessão NAT.
400 IllegalParam.SessionLogDeliveryType The specified Delivery Type is illegal. O valor especificado para o parâmetro de tipo de destino de entrega de log de sessão SessionLogDeliveryType é inválido.
400 UnsupportedFeature.EnableSessionLog The feature of EnableSessionLog is not supported. Os gateways NAT deste tipo de instância não suportam a ativação de logs de sessão.
500 OperationFailed.ConfigSessionLog Failed to configure session log due to a temporary failure of the server. Falha ao configurar a regra de entrega de log de sessão NAT.
403 Forbidden.ModifyEipBondType Authentication is failed for modify EIP bond type. A modificação do tipo de associação de EIP não é permitida.
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.