Todos os produtos
Search
Central de documentação

Virtual Private Cloud:DeleteVpc

Última atualização: Jul 14, 2026

Exclui uma nuvem privada virtual (VPC).

Descrição da operação

Ao chamar esta operação para excluir uma VPC, observe os seguintes itens:

  • Antes de excluir uma VPC, libere ou migre todos os recursos na VPC, incluindo vSwitches, instâncias de serviços em nuvem e endereços IP virtuais de alta disponibilidade.

  • Apenas VPCs no estado Available podem ser excluídas.

  • DeleteVpc é uma operação assíncrona. Após o envio da solicitação, o sistema retorna um ID de solicitação, mas a VPC ainda não foi excluída. A tarefa de exclusão é executada em segundo plano. Você pode chamar DescribeVpcAttribute para consultar o status de exclusão da VPC:

    • Se a VPC estiver no estado Deleting, a VPC está sendo excluída.

    • Se a VPC não for encontrada, a VPC foi excluída.

  • DeleteVpc não suporta a exclusão simultânea da mesma VPC.

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

delete

*VPC.

acs:vpc:{#regionId}:{#accountId}:vpc/{#VpcId}

  • vpc:tag
Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

VpcId

string

Sim

O ID da VPC que você deseja excluir.

vpc-bp1m7v25emi1h5mtc****

RegionId

string

Não

O ID da região da VPC que você deseja excluir.

Você pode chamar DescribeRegions para consultar o ID da região.

cn-hangzhou

ForceDelete

boolean

Não

Especifica se a VPC deve ser excluída à força. Valores válidos:

  • true: exclui a VPC à força.

  • false (padrão): não exclui a VPC à força.

Você só pode excluir uma VPC à força quando a VPC contiver apenas os seguintes recursos:

  • A VPC contém apenas um gateway IPv4 e rotas que apontam para o gateway IPv4.

  • A VPC contém apenas um gateway IPv6 e rotas que apontam para o gateway IPv6.

false

DryRun

boolean

Não

Especifica se deve ser realizado um dry run. Valores válidos:

  • true: realiza um dry run sem excluir a nuvem privada virtual (VPC). O sistema verifica os parâmetros obrigatórios, o formato da solicitação e as restrições de negócios. Se a verificação falhar, o erro correspondente será retornado. Se a verificação for bem-sucedida, o código de erro DryRunOperation será retornado.

  • false (padrão): envia uma solicitação normal. Após a solicitação passar na verificação, um código de status HTTP 2xx é retornado e a VPC é excluída.

false

ClientToken

string

Não

O token do cliente usado para garantir a idempotência da solicitação.

Você pode usar o cliente para gerar o token, mas deve garantir que o token seja exclusivo entre diferentes solicitações. O valor de ClientToken pode conter apenas caracteres ASCII.

Nota

Se você não especificar este parâmetro, o sistema usará o RequestId da solicitação de API como o ClientToken. O RequestId pode ser diferente para cada solicitação de API.

123e4567-e89b-12d3-a456-426655440000

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 IncorrectStatus.VpcDhcpStatus The DhcpOptionsSet status of vpc does not support this operation. Não é possível excluir a VPC porque o status da instância do conjunto de opções DHCP na VPC atual não suporta esta operação.
400 DependencyViolation.GatewayEndpoint The VPC contains endpoints and cannot be deleted. A VPC não pode ser excluída porque contém endpoints. Exclua os endpoints na VPC antes de excluir a VPC.
400 IncorrectVpcStatus Current VPC status does not support this operation.
400 DependencyViolation.RouteEntry Specified object has dependent resources O recurso atual ainda está referenciado por entradas de rota.
400 DependencyViolation.Instance Specified object has dependent resources
400 DependencyViolation.VSwitch Specified object has dependent resources Falha ao excluir uma VPC porque ela ainda contém vSwitches que não foram excluídos. Exclua os vSwitches na VPC primeiro e, em seguida, tente excluir a VPC.
400 DependencyViolation.RouteInterface Specified object has dependent route interface .
400 DependencyViolation.Tunnel Specified object has dependent tunnel.
400 DependencyViolation.NatGateway Specified object has dependent resources NatGateway. A VPC não pode ser excluída porque contém gateways NAT. Exclua os gateways NAT na VPC antes de excluir a VPC.
400 DependencyViolation.RouterInterface Specified object has dependent resources RouterInterface.
400 DependencyViolation.SecurityGroup Specified object has dependent resources SecurityGroup. Falha ao excluir uma VPC porque ela ainda contém o grupo de segurança [%s] que não foi excluído. Exclua os grupos de segurança na VPC primeiro e, em seguida, exclua a VPC.
400 Forbidden.VpcNotFound Specified VPC can not found. A VPC especificada não existe. Ver.
400 Forbbiden Active custom route in vpc.
400 TaskConflict The eip operate too frequent, TaskConflict. A operação é muito frequente. Aguarde um momento e tente novamente.
400 InvalidAction The VPC has been connected to the classic network ECS. Please cancel the connection before proceeding.
400 IncorrectStatus.cbnStatus Current CBN status does not support this operation. O estado atual da instância da Cloud Enterprise Network (CEN) está incorreto.
400 DependencyViolation.RouteTable Specified object has dependent custom routeTable.
400 DependencyViolation.NetworkAcl Specified object has dependent resources network acl. O vSwitch não pode ser excluído porque existe uma ACL de rede.
400 DependencyViolation.ClassicLinkInstance Specified object has active classicLink instance.
400 System.ServiceBusy System is busy, please try later.
400 DependencyViolation.DhcpOptionsSet The VPC cannot be deleted when it is associated with dhcpOptionsSet. A VPC não pode ser excluída porque ainda possui instâncias de conjunto de opções DHCP que não foram excluídas.
400 InvalidRegionId.NotFound The specified region is not found. O parâmetro é inválido.
400 DependencyViolation.CustomRouteTable CustomRouteTable already exists. Existe um conflito de dependência porque tabelas de rotas personalizadas estão presentes.
400 DependencyViolation.Ipv4Gateway The VPC cannot be deleted when it has ipv4Gateway. A VPC não pode ser excluída porque contém um gateway IPv4.
400 DependencyViolation.GatewayRouteTable Specified object has dependent resources gatewayRouteTable.
400 OperationDenied.VpcPeerExists The operation is not allowed because the VpcPeer exists. A operação foi negada porque existem instâncias de conexão de peering de VPC na VPC.
400 DependencyViolation.AppAccess Specified object has dependent resources app access. A VPC não pode ser excluída porque possui uma relação de autorização de acesso reverso.
400 DependencyViolation.OppositeRouterInterface Failed to delete the VPC because it has peer router interfaces. Falha ao excluir uma VPC porque a VPC possui interfaces de roteador pares que não foram excluídas.
400 DependencyViolation.TransitRouter Specified object has attached to Transit Router. O recurso especificado é dependência de outros recursos. A operação atual não é permitida.
400 DependencyViolation.Ipv6Gateway The VPC contains IPv6Gateway and cannot be deleted. A VPC não pode ser excluída porque contém um gateway IPv6.
400 DependencyViolation.CloudServiceResource The VPC contains CloudServiceResource and cannot be deleted. A VPC não pode ser excluída porque contém recursos EPS.
400 IncorrectStatus.VpcDnsHostnameStatus The DnsHostname status of vpc does not support this operation. O status do nome de domínio privado da VPC atual não suporta esta operação.
400 OperationDenied.AttachedToECR The operation is not allowed because the VPC is attached to ECR %s. A VPC está associada ao Express Connect Router (ECR) %s e não pode ser excluída.
400 IncorrectStatus.RouteTableStatus Route table [%s] status [%s] is not stable. Please try again later. A tabela de rotas [%s] está no estado [%s] e não atingiu um estado estável. Tente novamente mais tarde.
500 InternalError The request processing has failed due to some unknown error.
403 OperationDenied The operation is not supported in this status.
404 InvalidVpcId.NotFound Specified VPC does not exist.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.