Todos os produtos
Search
Central de documentação

VPN Gateway:DeleteVpnConnection

Última atualização: Oct 08, 2026

Exclui uma conexão IPsec-VPN especificada.

Descrição da operação

  • A operação DeleteVpnConnection é assíncrona. Após chamar esta operação, o sistema retorna um ID de solicitação, mas a conexão IPsec-VPN não é excluída imediatamente. A tarefa de exclusão ainda está em execução em segundo plano. Você pode chamar DescribeVpnGateway para consultar o status do gateway VPN e verificar o status de exclusão da conexão IPsec-VPN:
    • Se o gateway VPN estiver no estado updating, a conexão IPsec-VPN está sendo excluída.

    • Se o gateway VPN estiver no estado active, a conexão IPsec-VPN foi excluída.

  • A operação DeleteVpnConnection não oferece suporte à exclusão simultânea de conexões IPsec-VPN especificadas no mesmo gateway VPN.

Nota

Após a exclusão de uma conexão IPsec-VPN, a conexão entre o data center local e o Alibaba Cloud é interrompida.

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

delete

*VpnConnection.

acs:vpc:{#regionId}:{#accountId}:vpnconnection/{#VpnConnectionId}

Nenhuma Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

RegionId

string

Sim

O ID da região da conexão IPsec-VPN.

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

cn-hangzhou

ClientToken

string

Não

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

Você pode gerar o valor do parâmetro no seu cliente. Certifique-se de que o token de cliente seja exclusivo entre diferentes solicitações. O token de cliente pode conter apenas caracteres ASCII.

Nota

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

02fb3da4-130e-11e9-8e44-0016e04115b

VpnConnectionId

string

Sim

O ID da conexão IPsec-VPN.

vco-bp1bbi27hojx80nck****

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

RequestId

string

O ID da solicitação.

606998F0-B94D-48FE-8316-ACA81BB230DA

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "606998F0-B94D-48FE-8316-ACA81BB230DA"
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 VpnGateway.Configuring The specified service is configuring.
400 VpnTask.CONFLICT Vpn task has conflict. Ocorreu um conflito de operação de VPN. Tente novamente mais tarde.
400 VpnGateway.FinancialLocked The specified service is financial locked.
400 InternalError The request processing has failed due to some unknown error, exception or failure.
400 InvalidVpnGatewayInstanceId.NotFound The specified vpn gateway instance id does not exist. O gateway VPN especificado não existe. Verifique se o gateway VPN está correto.
403 Forbbiden.SubUser User not authorized to operate on the specified resource as your account is created by another user.
403 Forbidden User not authorized to operate on the specified resource. Você não tem as permissões para realizar operações no recurso especificado. Solicite as permissões necessárias e tente novamente.
404 InvalidVpnConnectionInstanceId.NotFound The specified vpn connection instance id does not exist. A conexão IPsec-VPN especificada não existe. Verifique se o ID da conexão VPN está correto.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.