Todos os produtos
Search
Central de documentação

VPN Gateway:ModifyVpnConnectionAttribute

Última atualização: Oct 09, 2026

Modifica as configurações de uma conexão IPsec-VPN.

Descrição da operação

  • Para modificar uma conexão IPsec-VPN no modo de túnel duplo, você pode configurar os seguintes parâmetros de solicitação, além dos parâmetros obrigatórios, ao chamar a operação ModifyVpnConnectionAttribute:

    ClientToken, Name, LocalSubnet, RemoteSubnet, EffectImmediately, AutoConfigRoute, array TunnelOptionsSpecification e EnableTunnelsBgp.

  • Para modificar uma conexão IPsec-VPN no modo de túnel único, você pode configurar os seguintes parâmetros de solicitação, além dos parâmetros obrigatórios, ao chamar a operação ModifyVpnConnectionAttribute:

    ClientToken, Name, LocalSubnet, RemoteSubnet, EffectImmediately, IkeConfig, IpsecConfig, HealthCheckConfig, AutoConfigRoute, EnableDpd, EnableNatTraversal, BgpConfig e RemoteCaCertificate.

  • A operação ModifyVpnConnectionAttribute é assíncrona. Após o envio da solicitação, o sistema retorna um ID de solicitação, mas as configurações da conexão IPsec-VPN não são modificadas imediatamente. O nó de modificação ainda está em execução em segundo plano. Você pode invocar a operação DescribeVpnGateway para consultar o status da instância do gateway VPN e verificar o status de modificação das configurações da conexão IPsec-VPN:\n - Se o gateway VPN estiver no estado updating, as configurações da conexão IPsec-VPN estão sendo modificadas.\n - Se o gateway VPN estiver no estado active, as configurações da conexão IPsec-VPN foram modificadas.\n- A operação ModifyVpnConnectionAttribute não suporta a modificação simultânea de configurações de conexão IPsec-VPN no mesmo gateway VPN.

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

update

*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. \n\nVocê pode chamar a operação DescribeRegions para consultar os IDs de região.

cn-shanghai

ClientToken

string

Não

O token de cliente usado para garantir a idempotência da solicitação.\n\nVocê pode usar o cliente para gerar o valor, mas deve garantir que ele seja exclusivo entre diferentes solicitações. O token de cliente pode conter apenas caracteres ASCII.\n\n> 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 é exclusivo.

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

VpnConnectionId

string

Sim

O ID da conexão IPsec-VPN.

vco-bp1bbi27hojx80nck****

Name

string

Não

O nome da conexão IPsec-VPN. \n\nO nome deve ter de 1 a 100 caracteres e não pode começar com http:// ou https://.

nametest

LocalSubnet

string

Não

O bloco CIDR no lado da VPC que precisa se comunicar com o data center. Este parâmetro é usado para negociações da Fase 2.\n\nSepare vários blocos CIDR com vírgulas (,). Exemplo: 192.168.1.0/24,192.168.2.0/24.\n\nModos de roteamento da conexão IPsec-VPN:\n\n- Se tanto LocalSubnet quanto RemoteSubnet estiverem definidos como 0.0.0.0/0, o modo de roteamento de destino será usado.\n- Se tanto LocalSubnet quanto RemoteSubnet estiverem definidos como blocos CIDR específicos, o modo de tráfego de interesse será usado.

10.1.1.0/24,10.1.2.0/24

RemoteSubnet

string

Não

O bloco CIDR no lado do data center. Este parâmetro é usado para negociações da Fase 2.\n\nSepare vários blocos CIDR com vírgulas (,). Exemplo: 192.168.3.0/24,192.168.4.0/24.\n\nModos de roteamento da conexão IPsec-VPN:\n\n- Se tanto LocalSubnet quanto RemoteSubnet estiverem definidos como 0.0.0.0/0, o modo de roteamento de destino será usado.\n- Se tanto LocalSubnet quanto RemoteSubnet estiverem definidos como blocos CIDR específicos, o modo de tráfego de interesse será usado.

10.2.1.0/24,10.2.2.0/24

EffectImmediately

boolean

Não

Especifica se as configurações da conexão IPsec-VPN entram em vigor imediatamente. Valores válidos:\n \n- true: Sim. O sistema inicia imediatamente as negociações IPsec após a conclusão das configurações.\n \n- false: Não. O sistema inicia as negociações IPsec apenas quando o tráfego é detectado.

false

IkeConfig

string

Não

Este parâmetro é suportado quando você modifica uma conexão IPsec-VPN no modo de túnel único.\n\nAs configurações para negociações da Fase 1: \n \n- IkeConfig.Psk: A chave pré-compartilhada usada para autenticação entre o gateway VPN e o data center.\n\n - A chave deve ter de 1 a 100 caracteres e pode conter dígitos, letras e os seguintes caracteres especiais: ~!`@#$%^&*()_-+={}[]|;:',.<>/? Não pode conter espaços.\n - Se você não especificar uma chave pré-compartilhada, o sistema gerará aleatoriamente uma string de 16 caracteres como a chave pré-compartilhada. Você pode chamar a operação DescribeVpnConnection para consultar a chave pré-compartilhada gerada automaticamente.\n > A chave pré-compartilhada no lado da conexão IPsec-VPN deve ser igual à chave de autenticação no lado do data center. Caso contrário, a conexão entre o data center e o gateway VPN não poderá ser estabelecida. \n\n- IkeConfig.IkeVersion: A versão do protocolo IKE. Valores válidos: ikev1 e ikev2. \n\n Em comparação com o IKEv1, o IKEv2 simplifica o processo de negociação de SA e oferece melhor suporte para cenários de múltiplos blocos CIDR.\n\n \n\n- IkeConfig.IkeMode: O modo de negociação da versão IKE. Valores válidos: main e aggressive. \n - main: O modo principal. O processo de negociação é altamente seguro.\n - aggressive: O modo agressivo. O processo de negociação é rápido e tem uma alta taxa de sucesso.\n\n \n\n- IkeConfig.IkeEncAlg: O algoritmo de criptografia usado nas negociações da Fase 1.\n\n Valores válidos: aes, aes192, aes256, des e 3des.\n\n \n\n \n\n- IkeConfig.IkeAuthAlg: O algoritmo de autenticação usado nas negociações da Fase 1.\n\n Valores válidos: md5, sha1, sha256, sha384 e sha512.\n\n \n\n \n\n- IkeConfig.IkePfs: O algoritmo de troca de chaves Diffie-Hellman usado nas negociações da Fase 1. Valores válidos: group1, group2, group5 e group14.\n\n- IkeConfig.IkeLifetime: O tempo de vida da SA determinado pelas negociações da Fase 1. Unidade: segundos. Valores válidos: 0 a 86400.\n\n- IkeConfig.LocalId: O identificador do gateway VPN. O identificador pode ter até 100 caracteres e não pode conter espaços. O valor padrão é o endereço IP do gateway VPN. \n\n- IkeConfig.RemoteId: O identificador do gateway do cliente. O identificador pode ter até 100 caracteres e não pode conter espaços. O valor padrão é o endereço IP do gateway do cliente.

{"Psk":"pgw6dy7d1i8i****","IkeVersion":"ikev1","IkeMode":"main","IkeEncAlg":"aes","IkeAuthAlg":"sha1","IkePfs":"group2","IkeLifetime":86400,"LocalId":"116.64.XX.XX","RemoteId":"139.18.XX.XX"}

IpsecConfig

string

Não

Este parâmetro é suportado quando você modifica uma conexão IPsec-VPN no modo de túnel único.\n\nAs configurações para negociações da Fase 2: \n\n- IpsecConfig.IpsecEncAlg: O algoritmo de criptografia usado nas negociações da Fase 2.\n\n Valores válidos: aes, aes192, aes256, des e 3des.\n\n \n\n \n\n- IpsecConfig.IpsecAuthAlg: O algoritmo de autenticação usado nas negociações da Fase 2.\n\n Valores válidos: md5, sha1, sha256, sha384 e sha512.\n\n \n\n \n\n- IpsecConfig.IpsecPfs: O algoritmo de troca de chaves Diffie-Hellman usado nas negociações da Fase 1 para encaminhamento de pacotes de todos os protocolos. Valores válidos: disabled, group1, group2, group5 e group14. \n\n- IpsecConfig.IpsecLifetime: O tempo de vida da SA determinado pelas negociações da Fase 2. Unidade: segundos. Valores válidos: 0 a 86400.

{"IpsecEncAlg":"aes","IpsecAuthAlg":"sha1","IpsecPfs":"group2","IpsecLifetime":86400}

HealthCheckConfig

string

Não

Este parâmetro é suportado quando você modifica uma conexão IPsec-VPN no modo de túnel único.\n\nAs configurações de verificação de integridade:\n\n- HealthCheckConfig.enable: Especifica se deve ativar as verificações de integridade. Valores válidos: true e false.\n\n- HealthCheckConfig.dip: O endereço IP de destino para verificações de integridade.\n\n- HealthCheckConfig.sip: O endereço IP de origem para verificações de integridade.\n\n- HealthCheckConfig.interval: O intervalo de nova tentativa para verificações de integridade. Unidade: segundos.\n\n- HealthCheckConfig.retry: O número máximo de novas tentativas de verificação de integridade.

{"enable":"true","dip":"192.168.1.1","sip":"10.1.1.1","interval":"3","retry":"3"}

AutoConfigRoute

boolean

Não

Especifica se deve publicar automaticamente a entrada de rota. Valores válidos:\n\n- true: Publica automaticamente a entrada de rota.\n \n- false: Não publica automaticamente a entrada de rota.

true

EnableDpd

boolean

Não

Este parâmetro é suportado quando você modifica uma conexão IPsec-VPN no modo de túnel único.\n\nEspecifica se deve ativar o recurso de detecção de peer inativo (DPD). Valores válidos:\n\n- true: Ativa o recurso DPD. O iniciador IPsec envia pacotes DPD para verificar se o dispositivo peer está ativo. Se nenhuma resposta correta for recebida dentro do tempo especificado, o peer é considerado desconectado. O IPsec exclui a SA ISAKMP e a SA IPsec correspondente, e o túnel seguro também é excluído.\n\n- false: Desativa o recurso DPD. O iniciador IPsec não envia pacotes de sondagem DPD.

true

EnableNatTraversal

boolean

Não

Este parâmetro é suportado quando você modifica uma conexão IPsec-VPN no modo de túnel único.\n\nEspecifica se deve ativar o recurso de travessia de NAT. Valores válidos:\n\n- true: Ativa o recurso de travessia de NAT. Após a ativação deste recurso, o processo de negociação IKE ignora a verificação de números de porta UDP e descobre dispositivos de gateway NAT no túnel VPN.\n\n- false: Desativa o recurso de travessia de NAT.

true

BgpConfig

string

Não

Este parâmetro é suportado quando você modifica uma conexão IPsec-VPN no modo de túnel único.\n\nAs configurações de BGP:\n\n- BgpConfig.EnableBgp: Especifica se deve ativar o recurso BGP. Valores válidos: true e false.\n\n- BgpConfig.LocalAsn: O número do sistema autônomo (ASN) no lado da Alibaba Cloud. Valores válidos: 1 a 4294967295. \n\n Você pode inserir o ASN em um formato de duas partes: os primeiros 16 bits e os últimos 16 bits, separados por um ponto. Cada parte deve ser inserida em formato decimal.\n\n Por exemplo, se você inserir 123.456, o ASN será calculado da seguinte forma: 123 × 65536 + 456 = 8061384.\n\n- BgpConfig.TunnelCidr: O bloco CIDR do túnel IPsec. O bloco CIDR deve ser uma sub-rede com comprimento de máscara de 30 dentro de 169.254.0.0/16, e não pode ser 169.254.0.0/30, 169.254.1.0/30, 169.254.2.0/30, 169.254.3.0/30, 169.254.4.0/30, 169.254.5.0/30, 169.254.6.0/30 ou 169.254.169.252/30.\n\n > O bloco CIDR do túnel IPsec de cada conexão IPsec-VPN na mesma instância de gateway VPN deve ser exclusivo.\n\n- LocalBgpIp: O endereço IP BGP no lado da Alibaba Cloud. Este endereço IP deve estar dentro do bloco CIDR do túnel IPsec. \n\n> - Este parâmetro é obrigatório quando o recurso de roteamento dinâmico BGP está ativado para o gateway VPN.\n> - Antes de adicionar configurações BGP, entenda o mecanismo de funcionamento e os limites do roteamento dinâmico BGP. Para mais informações, consulte Configurar roteamento dinâmico BGP.\n> - Use um ASN privado para estabelecer uma conexão BGP com a Alibaba Cloud. Consulte a documentação relevante para o intervalo de ASNs privados.

{"EnableBgp":"true","LocalAsn":"65530","TunnelCidr":"169.254.11.0/30","LocalBgpIp":"169.254.11.1"}

RemoteCaCertificate

string

Não

Este parâmetro é suportado quando você modifica uma conexão IPsec-VPN no modo de túnel único.\n\nSe o gateway VPN atual for um gateway VPN SM, você pode modificar o certificado CA do peer.\n\nSe o gateway VPN atual for um gateway VPN padrão, este parâmetro não é suportado.

-----BEGIN CERTIFICATE----- MIIB7zCCAZW**** -----END CERTIFICATE-----

TunnelOptionsSpecification

array<object>

Não

As configurações do túnel.\n\nOs parâmetros no array TunnelOptionsSpecification são suportados apenas quando você modifica uma conexão IPsec-VPN no modo de túnel duplo. Você pode modificar as configurações dos túneis primário e secundário da conexão IPsec-VPN ao mesmo tempo.

array<object>

Não

As configurações do túnel.

TunnelId

string

Não

O ID do túnel.

tun-opsqc4d97wni27****

CustomerGatewayId

string

Não

O ID da instância do gateway do cliente associado ao túnel.

cgw-1nmwbpgrp7ssqm1yn****

Role

string

Não

A função do túnel.\n\n- master: O túnel atual é o túnel primário.\n- slave: O túnel atual é o túnel secundário.

master

EnableDpd

boolean

Não

Especifica se deve ativar o recurso de detecção de peer inativo (DPD) para o túnel. Valores válidos:\n\n- true: Ativa o recurso DPD. O iniciador IPsec envia pacotes DPD para verificar se o dispositivo peer está ativo. Se nenhuma resposta correta for recebida dentro do tempo especificado, o peer é considerado desconectado. O IPsec exclui a SA ISAKMP e a SA IPsec correspondente, e o túnel seguro também é excluído.\n\n- false: Desativa o recurso DPD. O iniciador IPsec não envia pacotes de sondagem DPD.

true

EnableNatTraversal

boolean

Não

Especifica se deve ativar o recurso de travessia de NAT para o túnel. Valores válidos:\n\n- true: Ativa o recurso de travessia de NAT. Após a ativação deste recurso, o processo de negociação IKE ignora a verificação de números de porta UDP e descobre dispositivos de gateway NAT no túnel VPN.\n\n- false: Desativa o recurso de travessia de NAT.

true

RemoteCaCertificate

string

Não

Se o gateway VPN atual for um gateway VPN SM, você pode modificar o certificado CA do peer para o túnel.\n\nSe o gateway VPN atual for um gateway VPN padrão, este parâmetro não é suportado.

-----BEGIN CERTIFICATE----- MIIB7zCCAZW**** -----END CERTIFICATE-----

TunnelBgpConfig

object

Não

As configurações de BGP do túnel.

LocalAsn

integer

Não

O número do sistema autônomo (ASN) no lado da Alibaba Cloud do túnel. Valores válidos: 1 a 4294967295. Valor padrão: 45104.\n\n> - Este parâmetro pode ser configurado ou modificado somente após você ativar o recurso BGP para a conexão IPsec-VPN (ou seja, definir EnableTunnelsBgp como true).\n> - Antes de adicionar configurações BGP, entenda o mecanismo de funcionamento e os limites do roteamento dinâmico BGP. Para mais informações, consulte Configurar roteamento dinâmico BGP.\n> - Use um ASN privado para estabelecer uma conexão BGP com a Alibaba Cloud. Consulte a documentação relevante para o intervalo de ASNs privados.

65530

LocalBgpIp

string

Não

O endereço IP BGP no lado da Alibaba Cloud do túnel. Este endereço IP deve estar dentro do bloco CIDR BGP.

169.254.10.1

TunnelCidr

string

Não

O bloco CIDR BGP do túnel.\n\nO bloco CIDR deve ser uma sub-rede com comprimento de máscara de 30 dentro de 169.254.0.0/16, e não pode ser 169.254.0.0/30, 169.254.1.0/30, 169.254.2.0/30, 169.254.3.0/30, 169.254.4.0/30, 169.254.5.0/30, 169.254.6.0/30 ou 169.254.169.252/30.\n\n> O bloco CIDR BGP de cada túnel na mesma instância de gateway VPN deve ser exclusivo.

169.254.10.0/30

TunnelIkeConfig

object

Não

As configurações para negociações da Fase 1.

IkeAuthAlg

string

Não

O algoritmo de autenticação usado nas negociações da Fase 1.\n\nValores válidos: md5, sha1, sha256, sha384 e sha512.\n\n\n\n

md5

IkeEncAlg

string

Não

O algoritmo de criptografia usado nas negociações da Fase 1.\n\nValores válidos: aes, aes192, aes256, des e 3des.\n\n\n\n

aes

IkeLifetime

integer

Não

O tempo de vida da SA determinado pelas negociações da Fase 1. Unidade: segundos. Valores válidos: 0 a 86400.

86400

IkeMode

string

Não

O modo de negociação da versão IKE. Valores válidos:\n\n- main: O modo principal. O processo de negociação é altamente seguro.\n- aggressive: O modo agressivo. O processo de negociação é rápido e tem uma alta taxa de sucesso.\n\n

main

IkePfs

string

Não

O algoritmo de troca de chaves Diffie-Hellman usado nas negociações da Fase 1. Valores válidos: group1, group2, group5 e group14.

group2

IkeVersion

string

Não

A versão do protocolo IKE. Valores válidos: ikev1 e ikev2.\n\nEm comparação com o IKEv1, o IKEv2 simplifica o processo de negociação de SA e oferece melhor suporte para cenários de múltiplos blocos CIDR.\n\n

ikev1

LocalId

string

Não

O identificador no lado da Alibaba Cloud do túnel, que é usado para negociações da Fase 1. O identificador pode ter até 100 caracteres e não pode conter espaços. O valor padrão é o endereço IP do túnel.\n\nLocalId suporta o formato FQDN. Se você usar o formato FQDN, defina o modo de negociação como aggressive.

47.21.XX.XX

Psk

string

Não

A chave pré-compartilhada usada para autenticação entre o túnel e o peer.\n\n- A chave deve ter de 1 a 100 caracteres e pode conter dígitos, letras e os seguintes caracteres especiais: ~!`@#$%^&*()_-+={}[]|;:',.<>/? Não pode conter espaços.\n\n- Se você não especificar uma chave pré-compartilhada, o sistema gerará aleatoriamente uma string de 16 caracteres como a chave pré-compartilhada. Você pode chamar a operação DescribeVpnConnection para consultar a chave pré-compartilhada gerada automaticamente. \n\n> A chave pré-compartilhada do túnel deve ser igual à do peer. Caso contrário, o sistema não poderá estabelecer o túnel.

123456****

RemoteId

string

Não

O identificador do peer, que é usado para negociações da Fase 1. O identificador pode ter até 100 caracteres e não pode conter espaços. O valor padrão é o endereço IP do gateway do cliente associado ao túnel.\n\nRemoteId suporta o formato FQDN. Se você usar o formato FQDN, defina o modo de negociação como aggressive.

47.42.XX.XX

TunnelIpsecConfig

object

Não

As configurações para negociações da Fase 2.

IpsecAuthAlg

string

Não

O algoritmo de autenticação usado nas negociações da Fase 2.\n\nValores válidos: md5, sha1, sha256, sha384 e sha512.\n\n\n\n

md5

IpsecEncAlg

string

Não

O algoritmo de criptografia usado nas negociações da Fase 2.\n\nValores válidos: aes, aes192, aes256, des e 3des.\n\n\n\n

aes

IpsecLifetime

integer

Não

O tempo de vida da SA determinado pelas negociações da Fase 2. Unidade: segundos. Valores válidos: 0 a 86400.

86400

IpsecPfs

string

Não

O algoritmo de troca de chaves Diffie-Hellman usado nas negociações da Fase 2.\n\nValores válidos: disabled, group1, group2, group5 e group14.

group2

EnableTunnelsBgp

boolean

Não

Este parâmetro é suportado quando você modifica uma conexão IPsec-VPN no modo de túnel duplo.\n\nEspecifica se deve ativar o recurso BGP para o túnel. Valores válidos: true e false.

true

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

A resposta.

EnableNatTraversal

boolean

Indica se o NAT traversal está ativado para a conexão IPsec-VPN. Valores válidos:

  • false: O NAT traversal está desativado.

  • true: O NAT traversal está ativado.

Este parâmetro é retornado apenas para conexões IPsec-VPN no modo de túnel único.

true

CreateTime

integer

O carimbo de data e hora de quando a conexão IPsec-VPN foi criada. Unidade: milissegundos.

O carimbo de data e hora está no formato UNIX, que indica o número total de milissegundos decorridos desde 00:00:00 UTC em 1º de janeiro de 1970.

1492753817000

EffectImmediately

boolean

Indica se a configuração da conexão IPsec-VPN entra em vigor imediatamente. Valores válidos:

  • true: Sim. O sistema inicia imediatamente as negociações IPsec após a conclusão da configuração.

  • false: Não. O sistema inicia as negociações IPsec apenas quando o tráfego entra na conexão.

false

VpnGatewayId

string

O ID do gateway de VPN.

vpn-bp1q8bgx4xnkm2ogj****

LocalSubnet

string

O bloco CIDR no lado da VPC.

10.1.1.0/24,10.1.2.0/24

RequestId

string

O ID da solicitação.

7DB79D0C-5F27-4AB5-995B-79BE55102F90

VpnConnectionId

string

O ID da conexão IPsec-VPN.

vco-bp1bbi27hojx80nck****

Description

string

A descrição da conexão IPsec-VPN.

description

RemoteSubnet

string

O bloco CIDR do data center local.

10.2.1.0/24,10.2.2.0/24

CustomerGatewayId

string

O ID do gateway do cliente associado à conexão IPsec-VPN.

Este parâmetro é retornado apenas para conexões IPsec-VPN no modo de túnel único.

cgw-p0w2jemrcj5u61un8****

Name

string

O nome da conexão IPsec-VPN.

nametest

EnableDpd

boolean

Indica se a detecção de peer inativo (DPD) está ativada para a conexão IPsec-VPN. Valores válidos:

  • false: O DPD está desativado.

  • true: O DPD está ativado.

Este parâmetro é retornado apenas para conexões IPsec-VPN no modo de túnel único.

true

IkeConfig

object

A configuração de negociação da Fase 1.

Os parâmetros na matriz IkeConfig são retornados apenas para conexões IPsec-VPN no modo de túnel único.

RemoteId

string

O identificador do data center local. Há suporte para nomes de domínio totalmente qualificados (FQDNs) e endereços IP. Por padrão, este parâmetro é definido como o endereço IP do gateway do cliente selecionado.

139.18.XX.XX

IkeLifetime

integer

O tempo de vida do IKE SA. Unidade: segundos.

86400

IkeEncAlg

string

O algoritmo de criptografia para as negociações da Fase 1.

aes

LocalId

string

O identificador da VPC. Há suporte para FQDNs e endereços IP. Por padrão, este parâmetro é definido como o endereço IP do gateway de VPN selecionado.

116.64.XX.XX

IkeMode

string

O modo de negociação IKE. Valores válidos:

  • main: Modo principal. Este modo oferece alta segurança durante as negociações.

  • aggressive: Modo agressivo. Este modo apresenta negociações mais rápidas e uma taxa de sucesso maior.

main

IkeVersion

string

A versão do IKE. Valores válidos:

  • ikev1

  • ikev2

Em comparação com o IKEv1, o IKEv2 simplifica o processo de negociação de SA e oferece melhor suporte para cenários de múltiplos blocos CIDR.

ikev1

IkePfs

string

O grupo Diffie-Hellman (DH) para as negociações da Fase 1.

group2

Psk

string

A chave pré-compartilhada.

pgw6dy7d1i8i****

IkeAuthAlg

string

O algoritmo de autenticação para as negociações da Fase 1.

sha1

IpsecConfig

object

A configuração de negociação da Fase 2.

Os parâmetros na matriz IpsecConfig são retornados apenas para conexões IPsec-VPN no modo de túnel único.

IpsecAuthAlg

string

O algoritmo de autenticação para as negociações da Fase 2.

sha1

IpsecLifetime

integer

O tempo de vida do IPsec SA. Unidade: segundos.

86400

IpsecEncAlg

string

O algoritmo de criptografia para as negociações da Fase 2.

aes

IpsecPfs

string

O grupo DH para as negociações da Fase 2.

group2

VcoHealthCheck

object

A configuração de verificação de integridade.

Os parâmetros na matriz VcoHealthCheck são retornados apenas para conexões IPsec-VPN no modo de túnel único.

Dip

string

O endereço IP de destino.

192.168.1.1

Interval

integer

O intervalo de nova tentativa para verificações de integridade. Unidade: segundos.

3

Retry

integer

O número de novas tentativas de verificação de integridade.

3

Sip

string

O endereço IP de origem.

10.1.1.1

Enable

string

Indica se o recurso de verificação de integridade está ativado para a conexão IPsec-VPN. Valores válidos:

  • true: O recurso de verificação de integridade está ativado.

  • false: O recurso de verificação de integridade está desativado.

true

VpnBgpConfig

object

A configuração do BGP.

Os parâmetros na matriz VpnBgpConfig são retornados apenas para conexões IPsec-VPN no modo de túnel único.

Status

string

O status de negociação do BGP. Valores válidos:

  • success: Normal.

  • false: Anormal.

success

PeerBgpIp

string

O endereço IP do BGP no lado do data center local.

169.254.11.2

TunnelCidr

string

O bloco CIDR do BGP da conexão IPsec-VPN.

169.254.11.0/30

EnableBgp

string

O status de ativação do BGP. Valores válidos:

  • true: O BGP está ativado.

  • false: O BGP está desativado.

true

LocalBgpIp

string

O endereço IP do BGP no lado do Alibaba Cloud.

169.254.11.1

PeerAsn

integer

O número do sistema autônomo (ASN) do data center local.

65531

LocalAsn

integer

O número do sistema autônomo no lado do Alibaba Cloud.

65530

TunnelOptionsSpecification

object

TunnelOptions

array<object>

A configuração do túnel da conexão IPsec-VPN.

Os parâmetros na matriz TunnelOptionsSpecification são retornados apenas para conexões IPsec-VPN no modo de túnel duplo.

array<object>

A configuração do túnel.

CustomerGatewayId

string

O ID do gateway do cliente associado ao túnel.

cgw-p0wy363lucf1uyae8****

EnableDpd

boolean

Indica se o DPD está ativado para o túnel. Valores válidos:

  • false: O DPD está desativado.

  • true: O DPD está ativado.

true

EnableNatTraversal

boolean

Indica se o NAT traversal está ativado para o túnel. Valores válidos:

  • false: O NAT traversal está desativado.

  • true: O NAT traversal está ativado.

true

InternetIp

string

O endereço IP do gateway no lado do Alibaba Cloud do túnel.

47.21.XX.XX

RemoteCaCertificate

string

O certificado CA da extremidade par do túnel.

Este parâmetro é retornado apenas quando o gateway de VPN é do tipo SM.

-----BEGIN CERTIFICATE----- MIIB7zCCAZW**** -----END CERTIFICATE-----

Role

string

A função do túnel.

  • master: O túnel atual é o túnel primário.

  • slave: O túnel atual é o túnel secundário.

master

State

string

O status do túnel. Valores válidos:

  • active: O túnel está funcionando corretamente.

  • updating: O túnel está sendo atualizado.

  • deleting: O túnel está sendo excluído.

active

TunnelBgpConfig

object

A configuração do BGP do túnel.

LocalAsn

integer

O número do sistema autônomo da extremidade local (lado do Alibaba Cloud) do túnel.

65530

LocalBgpIp

string

O endereço IP do BGP da extremidade local (lado do Alibaba Cloud) do túnel.

169.254.10.1

PeerAsn

integer

O número do sistema autônomo da extremidade par do túnel.

65531

PeerBgpIp

string

O endereço IP do BGP da extremidade par do túnel.

169.254.10.2

TunnelCidr

string

O bloco CIDR do BGP do túnel.

169.254.10.0/30

TunnelId

string

O ID do túnel.

tun-opsqc4d97wni27****

TunnelIkeConfig

object

A configuração de negociação da Fase 1.

IkeAuthAlg

string

O algoritmo de autenticação para as negociações da Fase 1.

sha1

IkeEncAlg

string

O algoritmo de criptografia para as negociações da Fase 1.

aes

IkeLifetime

integer

O tempo de vida do IKE SA. Unidade: segundos.

86400

IkeMode

string

O modo de negociação IKE. Valores válidos:

  • main: Modo principal. Este modo oferece alta segurança durante as negociações.

  • aggressive: Modo agressivo. Este modo apresenta negociações mais rápidas e uma taxa de sucesso maior.

main

IkePfs

string

O grupo Diffie-Hellman (DH) para as negociações da Fase 1.

group2

IkeVersion

string

A versão do IKE.

ikev1

LocalId

string

O identificador da extremidade local (lado do Alibaba Cloud) do túnel.

47.21.XX.XX

Psk

string

A chave pré-compartilhada.

123456****

RemoteId

string

O identificador da extremidade par do túnel.

47.42.XX.XX

TunnelIpsecConfig

object

A configuração de negociação da Fase 2.

IpsecAuthAlg

string

O algoritmo de autenticação para as negociações da Fase 2.

sha1

IpsecEncAlg

string

O algoritmo de criptografia para as negociações da Fase 2.

aes

IpsecLifetime

integer

O tempo de vida do IPsec SA. Unidade: segundos.

86400

IpsecPfs

string

O grupo DH para as negociações da Fase 2.

group2

ZoneNo

string

A zona onde o túnel está implantado.

ap-southeast-5a

EnableTunnelsBgp

boolean

O status de ativação do BGP para o túnel. Valores válidos:

  • true: O BGP está ativado.

  • false: O BGP está desativado.

Este parâmetro é retornado apenas para conexões IPsec-VPN no padrão de túnel duplo.

true

ResourceGroupId

string

O ID do grupo de recursos ao qual a conexão IPsec-VPN pertence.

A conexão IPsec-VPN pertence ao mesmo grupo de recursos que seu gateway de VPN associado. Você pode chamar a operação ListResourceGroups para consultar as informações do grupo de recursos.

rg-acfmzs372yg****

Exemplos

Resposta de sucesso

JSON formato

{
  "EnableNatTraversal": true,
  "CreateTime": 1492753817000,
  "EffectImmediately": false,
  "VpnGatewayId": "vpn-bp1q8bgx4xnkm2ogj****",
  "LocalSubnet": "10.1.1.0/24,10.1.2.0/24",
  "RequestId": "7DB79D0C-5F27-4AB5-995B-79BE55102F90",
  "VpnConnectionId": "vco-bp1bbi27hojx80nck****",
  "Description": "description",
  "RemoteSubnet": "10.2.1.0/24,10.2.2.0/24",
  "CustomerGatewayId": "cgw-p0w2jemrcj5u61un8****",
  "Name": "nametest",
  "EnableDpd": true,
  "IkeConfig": {
    "RemoteId": "139.18.XX.XX",
    "IkeLifetime": 86400,
    "IkeEncAlg": "aes",
    "LocalId": "116.64.XX.XX",
    "IkeMode": "main",
    "IkeVersion": "ikev1",
    "IkePfs": "group2",
    "Psk": "pgw6dy7d1i8i****",
    "IkeAuthAlg": "sha1"
  },
  "IpsecConfig": {
    "IpsecAuthAlg": "sha1",
    "IpsecLifetime": 86400,
    "IpsecEncAlg": "aes",
    "IpsecPfs": "group2"
  },
  "VcoHealthCheck": {
    "Dip": "192.168.1.1",
    "Interval": 3,
    "Retry": 3,
    "Sip": "10.1.1.1",
    "Enable": "true"
  },
  "VpnBgpConfig": {
    "Status": "success",
    "PeerBgpIp": "169.254.11.2",
    "TunnelCidr": "169.254.11.0/30",
    "EnableBgp": "true",
    "LocalBgpIp": "169.254.11.1",
    "PeerAsn": 65531,
    "LocalAsn": 65530
  },
  "TunnelOptionsSpecification": {
    "TunnelOptions": [
      {
        "CustomerGatewayId": "cgw-p0wy363lucf1uyae8****",
        "EnableDpd": true,
        "EnableNatTraversal": true,
        "InternetIp": "47.21.XX.XX",
        "RemoteCaCertificate": "-----BEGIN CERTIFICATE----- MIIB7zCCAZW**** -----END CERTIFICATE-----",
        "Role": "master",
        "State": "active",
        "TunnelBgpConfig": {
          "LocalAsn": 65530,
          "LocalBgpIp": "169.254.10.1",
          "PeerAsn": 65531,
          "PeerBgpIp": "169.254.10.2",
          "TunnelCidr": "169.254.10.0/30"
        },
        "TunnelId": "tun-opsqc4d97wni27****",
        "TunnelIkeConfig": {
          "IkeAuthAlg": "sha1",
          "IkeEncAlg": "aes",
          "IkeLifetime": 86400,
          "IkeMode": "main",
          "IkePfs": "group2",
          "IkeVersion": "ikev1",
          "LocalId": "47.21.XX.XX",
          "Psk": "123456****",
          "RemoteId": "47.42.XX.XX"
        },
        "TunnelIpsecConfig": {
          "IpsecAuthAlg": "sha1",
          "IpsecEncAlg": "aes",
          "IpsecLifetime": 86400,
          "IpsecPfs": "group2"
        },
        "ZoneNo": "ap-southeast-5a"
      }
    ]
  },
  "EnableTunnelsBgp": true,
  "ResourceGroupId": "rg-acfmzs372yg****"
}

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 VpnGateway.FinancialLocked The specified service is financial locked.
400 InvalidName The name is not valid
400 VpnRouteEntry.AlreadyExists The specified route entry is already exist. A rota já existe.
400 VpnRouteEntry.Conflict The specified route entry has conflict. Existe um conflito de entrada de rota.
400 NotSupportVpnConnectionParameter.IpsecPfs The specified vpn connection ipsec Ipsec Pfs is not support. O parâmetro PFS especificado para a conexão IPsec-VPN não é suportado.
400 NotSupportVpnConnectionParameter.IpsecAuthAlg The specified vpn connection ipsec Auth Alg is not support. O algoritmo de autenticação especificado para a conexão IPsec-VPN não é suportado.
400 VpnRouteEntry.ConflictSSL The specified route entry has conflict with SSL client. A entrada de rota entra em conflito com o cliente SSL.
400 VpnRouteEntry.BackupRoute Validate backup route entry failed. A validação da entrada de rotas ativas/em standby falhou. A configuração de roteamento é inválida.
400 VpnRouteEntry.InvalidWeight Invalid route entry weight value. O valor do peso da rota é inválido.
400 QuotaExceeded.PBR The policy-based routes has reached the upper limit. O número de rotas de política atingiu o limite máximo.
400 OperationUnsupported.SetDPD Current version of the VPN does not support setting DPD. A versão atual do gateway VPN não suporta o recurso DPD.
400 OperationUnsupported.SetNatTraversal Current version of the VPN does not support setting NAT traversal. A versão atual do gateway VPN não suporta NAT traversal.
400 QuotaExceeded.PolicyBasedRoute The maximum number of policy-based routes is exceeded. Existing routes: %s. Routes to be created: %s. Maximum routes: %s. O número de rotas de política atingiu o limite superior. A contagem atual é %s, esta operação criará mais %s e o limite superior é %s.
400 MissingParameter.TunnelCidr The parameter TunnelCidr is mandatory when BGP is enabled. O parâmetro de bloco CIDR do túnel é obrigatório quando o BGP está ativado.
400 OperationUnsupported.EnableBgp Current version of the VPN does not support enable BGP. A versão atual do gateway VPN não suporta BGP.
400 MissingParam.CustomerGatewayAsn Asn of customer gateway is mandatory when BGP is enabled. Quando o BGP está ativado, o número do sistema autônomo do gateway do cliente não pode estar vazio.
400 IllegalParam.LocalAsn The specified LocalAsn is invalid. O número do sistema autônomo local é inválido.
400 IllegalParam.BgpConfig The specified BgpConfig is invalid. A configuração BGP especificada é inválida.
400 IllegalParam.EnableBgp VPN connection must enable BGP when VPN gateway has enabled BGP. Quando o BGP está ativado para um gateway VPN, o BGP também deve estar ativado para a conexão VPN.
400 IllegalParam.TunnelCidr The specified TunnelCidr is invalid. O parâmetro TunnelCidr é inválido.
400 InvalidLocalBgpIp.Malformed The specified LocalBgpIp is malformed. O endereço IP BGP local especificado é inválido.
400 IllegalParam.LocalBgpIp The specified LocalBgpIp is invalid. O endereço BGP local é inválido.
400 IllegalParam.LocalSubnet The specified "LocalSubnet" (%s) is invalid. O bloco CIDR local (%s) é inválido.
400 IllegalParam.RemoteSubnet The specified "RemoteSubnet" (%s) is invalid. O bloco CIDR remoto (%s) é inválido.
400 OperationFailed.CenLevelNotSupport When the VPC to which the VPN gateway belongs is attached to a FULL-mode CEN, the VPN gateway cannot enable BGP. O BGP não pode ser ativado para um gateway VPN quando a VPC à qual o gateway VPN pertence está anexada a uma instância do Cloud Enterprise Network com a sincronização de rotas ativada.
400 InvalidTunnelCidr.Malformed The specified TunnelCidr is malformed. O bloco CIDR do túnel especificado é inválido.
400 CustomerGateway.ConflictRouteEntry The specified customer gateway has conflict with route entry. Existe um conflito entre o gateway do usuário atual e a rota.
400 VpnTask.CONFLICT Vpn task has conflict. Ocorreu um conflito de operação de VPN. Tente novamente mais tarde.
400 OperationFailed.RouteConflictWithIPsecServer Operation failed because the route to create conflicts with the client IP pool of the IPsec server. O bloco CIDR de destino da rota entra em conflito com o bloco CIDR do cliente do servidor IPsec.
400 IllegalParam.TunnelId The specified TunnelId is invalid. O parâmetro TunnelId é inválido.
400 IllegalParam.Role The specified Role is invalid. O parâmetro Role é inválido.
400 VpnConnectionParamInvalid.SameVpnAndCgwDifferentIkeConfigs IPSec connections associated with the same user gateway and VPN gateway should have the same pre-shared key and IKE configuration. Várias conexões IPsec-VPN estão associadas ao mesmo gateway VPN e gateway do cliente. As chaves pré-compartilhadas e os parâmetros de configuração da fase IKE dessas conexões IPsec-VPN devem ser idênticos.
400 VpnConnectionParamInvalid.SameVpnAndCgwTrafficSelectorOverlap Traffic selectors of IPSec connections associated with the same user gateway and VPN gateway should not overlap. Várias conexões IPsec-VPN estão associadas ao mesmo gateway VPN e gateway do cliente. Os blocos CIDR de tráfego de interesse dessas conexões IPsec-VPN não podem se sobrepor.
400 ModifyIkeV1WithMultiRoutes.Invalid Failed to modify VPN connection parameters. Multi-network is configured while using IkeV1 protocol. Falha ao modificar os parâmetros da conexão VPN-VPN. Vários segmentos de rede estão configurados enquanto o protocolo IKEv1 está em uso.
400 Vco.StatusNotSupport The current VPN connection state does not support this operation. O status atual da instância não oferece suporte a esta operação.
400 IkeVersionInvalid.GcmIncompatible Ikev1 does not support IkeEncAlg of gcm16. O IKEv1 não suporta a configuração apenas do algoritmo GCM-16 como o algoritmo de criptografia IKE.
400 EncAlgInvalid.DesIncompatible Des/3des in IkeEncAlg and IpsecEncAlg does not support multi algorithm. O DES e o 3DES não suportam compatibilidade com vários algoritmos em algoritmos de criptografia IKE ou algoritmos de criptografia IPsec.
400 CustomerGateway.ConflictVpnIp The specified customer gateway has conflict with vpn gateway ip. O gateway do cliente associado à conexão IPsec-VPN não deve ter o mesmo endereço IP de gateway que o gateway VPN.
400 CustomerGateway.AsnNotConfigured ASN of CustomerGateway is required when enabling BGP on an IPSec connection. Quando o BGP está ativado para uma conexão IPsec-VPN, você deve configurar um ASN no customer gateway.
500 OperationFailed.RouteConflictWithIPsecServer Operation failed because the specified route conflicts with IPsec server. O bloco CIDR de destino da rota entra em conflito com o bloco CIDR do cliente do servidor IPsec.
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.