Todos os produtos
Search
Central de documentação

NAT Gateway:DeleteNatGateway

Última atualização: Jun 29, 2026

Exclui um gateway NAT da Internet especificado.

Descrição da operação

Descrição

  • A operação DeleteNatGateway é assíncrona. Após o envio de uma solicitação, o sistema retorna um ID de solicitação e executa a tarefa em segundo plano. Você pode chamar a operação DescribeNatGateways para consultar o status da tarefa.

    • Se um gateway NAT estiver no estado Deleting, o gateway NAT está sendo excluído. Nesse caso, você pode consultar o gateway NAT, mas não pode executar outras operações.

    • Se o gateway NAT não puder ser encontrado, significa que ele foi excluído.

      Após excluir um gateway NAT, você não poderá restaurá-lo. Prossiga com cautela.

  • Você não pode chamar repetidamente a operação DeleteNatGateway para excluir um gateway NAT dentro do período de tempo especificado.

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

ngw-bp1uewa15k4iy5770****

Force

boolean

Não

Especifica se o gateway NAT deve ser excluído à força. Valores válidos:

  • true Se você definir o valor como true:

    • Se o gateway NAT tiver entradas SNAT, o sistema as excluirá automaticamente.

    • Se o gateway NAT tiver entradas DNAT, o sistema as excluirá automaticamente.

    • Se o gateway NAT estiver associado a um endereço elastic IP (EIP), o sistema desassociará automaticamente o EIP do gateway NAT.

    • Se o gateway NAT estiver associado a um plano de largura de banda NAT, o sistema desassociará automaticamente o plano de largura de banda NAT.

  • false (padrão): não. Se você definir o valor como false:

    • Se o gateway NAT estiver associado a um plano de largura de banda NAT, desassocie o plano de largura de banda NAT primeiro.

    • Se o gateway NAT tiver entradas SNAT, exclua-as primeiro.

    • Se o gateway NAT tiver entradas DNAT, exclua-as primeiro.

    • Se o gateway NAT estiver associado a um EIP, desassocie o EIP do gateway NAT primeiro.

false

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

O ID da solicitação.

RequestId

string

O ID da solicitação.

0ED8D006-F706-4D23-88ED-E11ED28DCAC0

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "0ED8D006-F706-4D23-88ED-E11ED28DCAC0"
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 DependencyViolation.VpcEndpointService The specified resource of %s depends on %s, so the operation cannot be completed. You cannot perform the operation because the NAT gateway is associated with an endpoint service.
400 DependencyViolation.FullNatEntry The specified resource of %s depends on %s, so the operation cannot be completed.
400 DependencyViolation.RouterEntry The specified resource of %s depends on %s, so the operation cannot be completed. You cannot perform the operation because the NAT gateway is associated with a route entry.
400 DependencyViolation.BandwidthPackages There are BandwidthPackages on specified NatGateway not deleted.
400 DependencyViolation.EIPS There are Eips on specified NatGateway, please unbind it first. An EIP is associated with the NAT gateway. Disassociate the EIP from the NAT gateway first.
400 Forbidden.PrePaidNatGateway The specified NatGateway is PrePaid.
400 InvalidOperation.DeletionProtection The instance cannnot delete because of deletion protecion.
400 DependencyViolation.SnatEntry The specified resource of %s depends on %s, so the operation cannot be completed. The SnatEntry associated with NatIp or Ipv4Prefix cannot be deleted. Delete the dependent Snat and delete it again.
400 IncorrectStatus.SnatEntry The status of %s [%s] is incorrect.
400 DependencyViolation.ForwardEntry The specified resource of %s depends on %s, so the operation cannot be completed.
400 IncorrectStatus.ForwardEntry The status of %s [%s] is incorrect. The DNAT entry to be deleted is in an invalid state.
400 DependencyViolation.NatIp The specified resource of %s depends on %s, so the operation cannot be completed. You cannot perform the operation because the NAT gateway is associated with a NAT IP address.
400 IncorrectStatus.NatIp The status of %s [%s] is incorrect. The status of NatIp is incorrect.
400 DependencyViolation.NatIpCidr The specified resource of %s depends on %s, so the operation cannot be completed. You cannot perform the operation because the NAT gateway is associated with a NAT CIDR block.
400 IncorrectStatus.NatGateway The NatGateway instance is being deleted and needs to wait until the process is complete. The NAT Gateway instance is being deleted and cannot be repeatedly deleted. You need to wait for the deletion process to complete.
400 IncorrectStatus.RouterEntry The status of %s [%s] is incorrect. The state of the RouterEntry is incorrect.
400 IncorrectStatus.VSwitch The specified vSwitch status is invalid. The virtual switch status is abnormal.
404 INSTANCE_NOT_EXISTS Instance not exists.
404 InvalidRegionId.NotFound The specified RegionId does not exist in our records.
404 InvalidNatGatewayId.NotFound The specified NatGatewayId does not exist in our records.
404 ResourceNotFound.NatGateway The specified resource of %s is not found.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.