DeleteNatGateway - NAT Gateway: Central de Documentação do Alibaba Cloud

Exclui um gateway NAT da Internet especificado.

Descrição da operação

DeleteNatGateway é uma operação assíncrona. Após o envio de uma solicitação, o sistema retorna um ID de solicitação. No entanto, o gateway NAT não é excluído imediatamente. A tarefa de exclusão é executada em segundo plano. Você pode chamar DescribeNatGateways para consultar o status do gateway NAT:

Se o gateway NAT estiver no estado Deleting, o gateway NAT está sendo excluído. Nesse estado, você só pode realizar operações de consulta.
Se o gateway NAT não for encontrado, o gateway NAT foi excluído.

Nota

A exclusão de um gateway NAT é irreversível. Prossiga com cautela.

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

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

vpc:DeleteNatGateway

delete

*NatGateway.

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

Nenhuma

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 DescribeRegions para consultar o ID da região.	cn-hangzhou
NatGatewayId	string	Sim	O ID da instância 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: exclui o gateway NAT à força. Se você definir este parâmetro como true: Se o gateway NAT tiver regras SNAT, o sistema excluirá à força as regras SNAT. Se o gateway NAT tiver regras DNAT, o sistema excluirá à força as regras DNAT. Se o gateway NAT tiver endereços IP elásticos (EIPs) associados, o sistema desassociará automaticamente os EIPs. Se o gateway NAT tiver planos de serviço NAT não excluídos, o sistema excluirá à força os planos de serviço NAT. false (padrão): não exclui o gateway NAT à força. Se você definir este parâmetro como false: Se o gateway NAT tiver planos de serviço NAT não excluídos, exclua primeiro os planos de serviço NAT. Se o gateway NAT tiver regras SNAT, exclua primeiro as regras SNAT. Se o gateway NAT tiver regras DNAT, exclua primeiro as regras DNAT. Se o gateway NAT tiver EIPs associados, desassocie primeiro os EIPs.	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.	O gateway NAT possui serviços de endpoint dependentes. Esta operação não pode ser realizada.
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.	A operação não pode ser concluída porque o gateway NAT possui entradas de rota dependentes.
400	DependencyViolation.BandwidthPackages	There are BandwidthPackages on specified NatGateway not deleted.
400	DependencyViolation.EIPS	There are Eips on specified NatGateway, please unbind it first.	O gateway NAT especificado já está associado a um elastic IP address (EIP). Desassocie o EIP do gateway NAT primeiro.
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.	O NatIp ou Ipv4Prefix está associado a entradas SNAT. A operação de exclusão não pode prosseguir. Exclua primeiro as entradas SNAT dependentes e tente novamente.
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.	A instância da entrada DNAT não pode ser excluída porque o status da instância está incorreto.
400	DependencyViolation.NatIp	The specified resource of %s depends on %s, so the operation cannot be completed.	A operação não pode ser concluída porque existe um endereço IP NAT dependente.
400	IncorrectStatus.NatIp	The status of %s [%s] is incorrect.	O endereço IP NAT está em um estado intermediário. Tente novamente mais tarde.
400	DependencyViolation.NatIpCidr	The specified resource of %s depends on %s, so the operation cannot be completed.	A operação não pode ser concluída porque o gateway NAT possui um bloco CIDR NAT dependente.
400	IncorrectStatus.NatGateway	The NatGateway instance is being deleted and needs to wait until the process is complete.	O gateway NAT especificado não está em um estado estável.
400	IncorrectStatus.RouterEntry	The status of %s [%s] is incorrect.	O estado atual da RouterEntry está incorreto.
400	IncorrectStatus.VSwitch	The specified vSwitch status is invalid.
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.