Crie uma conexão IPsec-VPN.
Observações de uso
-
Se o VPN gateway suportar o modo de túnel duplo, especifique os seguintes parâmetros adicionais aos obrigatórios ao chamar
CreateVpnConnection:ClientToken, Name, EffectImmediately, AutoConfigRoute, array Tags, array TunnelOptionsSpecification e EnableTunnelsBgp.
Para obter mais informações sobre as regiões e zonas que suportam o modo de túnel duplo, consulte Conexões IPsec-VPN suportam o modo de túnel duplo.
-
Caso o VPN gateway suporte apenas o modo de túnel duplo, defina os seguintes parâmetros adicionais aos obrigatórios ao chamar
CreateVpnConnection:ClientToken, CustomerGatewayId, Name, EffectImmediately, IkeConfig, IpsecConfig, HealthCheckConfig, AutoConfigRoute, EnableDpd, EnableNatTraversal, BgpConfig, RemoteCaCertificate e o array Tags.
-
A operação CreateVpnConnection é assíncrona. Após o envio da solicitação, o sistema retorna um ID de solicitação e executa a tarefa em segundo plano. Para consultar o status da tarefa, chame DescribeVpnGateway.
Quando o VPN gateway estiver no estado updating, a conexão IPsec-VPN está sendo criada.
Se o VPN gateway apresentar o estado active, a conexão IPsec-VPN foi criada com sucesso.
Não chame CreateVpnConnection repetidamente para criar uma conexão IPsec-VPN no mesmo VPN gateway dentro de um curto período de tempo.
Depuração
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Exemplo |
Descrição |
| Action | String | Sim | CreateVpnConnection | A operação que você deseja executar. Defina o valor como CreateVpnConnection. |
| RegionId | String | Sim | cn-shanghai | O ID da região onde você deseja criar a conexão IPsec-VPN. É possível obter a lista mais recente de regiões chamando a operação DescribeRegions. |
| ClientToken | String | Não | 02fb3da4-130e-11e9-8e44-001**** | O token do cliente usado para garantir a idempotência da solicitação. Você pode gerar esse token no cliente, mas deve garantir que seja único entre diferentes solicitações. O token do cliente aceita apenas caracteres ASCII. Nota
Caso este parâmetro não seja especificado, o sistema utilizará automaticamente o ID da solicitação como token do cliente. O ID da solicitação pode variar a cada solicitação. |
| CustomerGatewayId | String | Não | cgw-p0w2jemrcj5u61un8**** | Este parâmetro é obrigatório ao criar uma conexão IPsec-VPN no modo de túnel único. O ID do customer gateway. |
| VpnGatewayId | String | Sim | vpn-bp1q8bgx4xnkm**** | O ID do VPN gateway. |
| Name | String | Não | IPsec | O nome da conexão IPsec-VPN. O nome deve ter entre 1 e 100 caracteres e não pode começar com |
| LocalSubnet | String | Sim | 10.10.1.0/24,10.10.2.0/24 | O bloco CIDR do lado da virtual private cloud (VPC), utilizado nas negociações da Fase 2. Separe múltiplos blocos CIDR por vírgulas (,). Exemplo: 192.168.1.0/24,192.168.2.0/24. Os seguintes modos de roteamento são suportados:
|
| RemoteSubnet | String | Sim | 10.10.3.0/24,10.10.4.0/24 | Bloco CIDR referente ao data center local, aplicado nas negociações da Fase 2. Utilize vírgulas (,) para separar os blocos CIDR. Exemplo: 192.168.3.0/24,192.168.4.0/24. Modos de roteamento disponíveis:
|
| EffectImmediately | Boolean | Não | false | Define se as negociações IPsec devem iniciar imediatamente. Valores válidos:
|
| IkeConfig | String | Não | {"Psk":"1234****","IkeVersion":"ikev1","IkeMode":"main","IkeEncAlg":"aes","IkeAuthAlg":"sha1","IkePfs":"group2","IkeLifetime":86400,"LocalId":"47.XX.XX.1","RemoteId":"47.XX.XX.2"} | Parâmetro disponível para conexões IPsec-VPN criadas no modo de túnel único. Configurações das negociações da Fase 1:
|
| IpsecConfig | String | Não | {"IpsecEncAlg":"aes","IpsecAuthAlg":"sha1","IpsecPfs":"group2","IpsecLifetime":86400} | Aplicável apenas na criação de conexões IPsec-VPN em modo de túnel único. Configurações das negociações da Fase 2:
|
| HealthCheckConfig | String | Não | {"enable":"true","dip":"192.168.10.1","sip":"10.10.1.1","interval":"3","retry":"3"} | Disponível para conexões IPsec-VPN configuradas em modo de túnel único. Parâmetros de verificação de integridade:
|
| AutoConfigRoute | Boolean | Não | true | Indica se as rotas devem ser configuradas automaticamente. Valores válidos:
|
| EnableDpd | Boolean | Não | true | Recurso exclusivo do modo de túnel único. Ative ou não o recurso Dead Peer Detection (DPD). Opções:
|
| EnableNatTraversal | Boolean | Não | true | Parâmetro aplicável ao modo de túnel único. Controla a ativação da travessia de nat. Valores possíveis:
|
| BgpConfig | String | Não | {"EnableBgp":"true","LocalAsn":"45104","TunnelCidr":"169.254.11.0/30","LocalBgpIp":"169.254.11.1"} | Utilizado na criação de conexões IPsec-VPN em modo de túnel único. Configuração do Border Gateway Protocol (BGP):
Nota
|
| RemoteCaCertificate | String | Não | -----BEGIN CERTIFICATE----- MIIB7zCCAZW**** -----END CERTIFICATE----- | Válido para conexões IPsec-VPN em modo de túnel único. VPN gateways do tipo ShangMi (SM) exigem a configuração de um certificado CA para o dispositivo gateway remoto.
|
| Tags.N.Key | String | Não | TagKey | Chave da tag N a ser associada ao recurso. Não aceita strings vazias. Comprimento máximo de 64 caracteres; não pode conter Limite de 20 chaves de tag por chamada. |
| Tags.N.Value | String | Não | TagValue | Valor correspondente à tag N adicionada ao recurso. Aceita string vazia e até 128 caracteres. Restrições: não pode começar com Cada chave de tag possui um valor associado. Máximo de 20 valores de tag por solicitação. |
| TunnelOptionsSpecification.N.CustomerGatewayId | String | Não | cgw-p0wy363lucf1uyae8**** | ID do customer gateway vinculado ao túnel. Nota
|
| TunnelOptionsSpecification.N.EnableDpd | Boolean | Não | true | Ative o DPD para o túnel específico. Valores:
|
| TunnelOptionsSpecification.N.EnableNatTraversal | Boolean | Não | true | Determina se a travessia de nat estará ativa no túnel. Opções:
|
| TunnelOptionsSpecification.N.RemoteCaCertificate | String | Não | -----BEGIN CERTIFICATE----- MIIB7zCCAZW**** -----END CERTIFICATE----- | Necessário para configure o certificado CA do dispositivo remoto em VPN gateways do tipo SM.
|
| TunnelOptionsSpecification.N.Role | String | Não | master | Função atribuída ao túnel. Valores válidos:
|
| TunnelOptionsSpecification.N.TunnelBgpConfig.LocalAsn | Long | Não | 65530 | Número do sistema autônomo (ASN) da Alibaba Cloud. Faixa: 1 a 4294967295. Valor padrão: 45104. Nota
|
| TunnelOptionsSpecification.N.TunnelBgpConfig.LocalBgpIp | String | Não | 169.254.10.1 | Endereço BGP da Alibaba Cloud. Deve ser um IP pertencente ao bloco CIDR BGP configurado. |
| TunnelOptionsSpecification.N.TunnelBgpConfig.TunnelCidr | String | Não | 169.254.10.0/30 | Bloco CIDR BGP destinado ao túnel. Precisa estar dentro de 169.254.0.0/16 e ter máscara de 30 bits. Nota
O bloco CIDR BGP de cada túnel em um VPN gateway deve ser exclusivo. |
| TunnelOptionsSpecification.N.TunnelIkeConfig.IkeAuthAlg | String | Não | md5 | Algoritmo de autenticação da Fase 1. Valores válidos: md5, sha1, sha256, sha384 e sha512. Padrão: md5. |
| TunnelOptionsSpecification.N.TunnelIkeConfig.IkeEncAlg | String | Não | aes | Algoritmo de criptografia utilizado na Fase 1. Opções: aes, aes192, aes256, des e 3des. Valor padrão: aes. |
| TunnelOptionsSpecification.N.TunnelIkeConfig.IkeLifetime | Long | Não | 86400 | Tempo de vida da SA negociado na Fase 1, medido em segundos. Intervalo: 0 a 86400. Valor padrão: 86400. |
| TunnelOptionsSpecification.N.TunnelIkeConfig.IkeMode | String | Não | main | Modo de negociação IKE. Escolha entre main e aggressive. Valor padrão: main.
|
| TunnelOptionsSpecification.N.TunnelIkeConfig.IkePfs | String | Não | group2 | Algoritmo DH de troca de chaves na Fase 1. Valor padrão: group2. |
| TunnelOptionsSpecification.N.TunnelIkeConfig.IkeVersion | String | Não | ikev1 | Versão do protocolo IKE. Suporta ikev1 e ikev2. Padrão: ikev1. O IKEv2 simplifica a negociação de SA comparado ao IKEv1, sendo ideal para ambientes com diversos blocos CIDR. |
| TunnelOptionsSpecification.N.TunnelIkeConfig.LocalId | String | Não | 47.21.XX.XX | Identificador da Alibaba Cloud usado na Fase 1. Aceita até 100 caracteres, assumindo o IP do túnel como padrão. É possível definir LocalId como um FQDN (nome de domínio totalmente qualificado). Nesse caso, recomenda-se alterar o Modo de Negociação para aggressive. |
| TunnelOptionsSpecification.N.TunnelIkeConfig.Psk | String | Não | 123456**** | Chave pré-compartilhada para autenticação de identidade entre o túnel e seu par.
|
| TunnelOptionsSpecification.N.TunnelIkeConfig.RemoteId | String | Não | 47.42.XX.XX | Identificador do par do túnel para a Fase 1. Limite de 100 caracteres, tendo o IP do customer gateway como valor padrão. Também aceita FQDN em RemoteId, situação em que o uso do modo de negociação aggressive é recomendado. |
| TunnelOptionsSpecification.N.TunnelIpsecConfig.IpsecAuthAlg | String | Não | md5 | Algoritmo de autenticação aplicado na Fase 2. Valores permitidos: md5, sha1, sha256, sha384 e sha512. Padrão: md5. |
| TunnelOptionsSpecification.N.TunnelIpsecConfig.IpsecEncAlg | String | Não | aes | Algoritmo de criptografia da Fase 2. Seleção disponível: aes, aes192, aes256, des e 3des. Valor padrão: aes. |
| TunnelOptionsSpecification.N.TunnelIpsecConfig.IpsecLifetime | Long | Não | 86400 | Duração da SA definida na Fase 2, expressa em segundos. Faixa válida: 0 a 86400. Valor padrão: 86400. |
| TunnelOptionsSpecification.N.TunnelIpsecConfig.IpsecPfs | String | Não | group2 | Algoritmo Diffie-Hellman para troca de chaves na Fase 2. Valor padrão: group2. Valores aceitos: disabled, group1, group2, group5 e group14. |
| EnableTunnelsBgp | Boolean | Não | true | Exclusivo para conexões IPsec-VPN em modo de túnel duplo. Defina a ativação do recurso BGP no túnel. Valores: true e false. Valor padrão: false. |
Parâmetros de resposta
|
Parâmetro |
Tipo |
Exemplo |
Descrição |
|
RequestId |
String |
082AD562-B8DB-4BB2-861F-DA1FCA01FD76 |
O ID da solicitação. |
|
VpnConnectionId |
String |
vco-bp15oes1py4i6**** |
O ID da conexão IPsec-VPN. |
|
Name |
String |
test |
O nome da conexão IPsec-VPN. |
|
CreateTime |
Long |
1544666102000 |
Timestamp de criação da conexão IPsec-VPN. Unidade: milissegundos. Representa um timestamp UNIX indicando os milissegundos decorridos desde a época (1º de janeiro de 1970, 00:00:00 UTC). |
Exemplos
Exemplos de solicitações
http(s)://[Endpoint]/?Action=CreateVpnConnection
&RegionId=cn-shanghai
&ClientToken=02fb3da4-130e-11e9-8e44-001****
&CustomerGatewayId=cgw-p0w2jemrcj5u61un8****
&VpnGatewayId=vpn-bp1q8bgx4xnkm****
&Name=IPsec
&LocalSubnet=10.10.1.0/24,10.10.2.0/24
&RemoteSubnet=10.10.3.0/24,10.10.4.0/24
&EffectImmediately=false
&IkeConfig={"Psk":"1234****","IkeVersion":"ikev1","IkeMode":"main","IkeEncAlg":"aes","IkeAuthAlg":"sha1","IkePfs":"group2","IkeLifetime":86400,"LocalId":"47.XX.XX.1","RemoteId":"47.XX.XX.2"}
&IpsecConfig={"IpsecEncAlg":"aes","IpsecAuthAlg":"sha1","IpsecPfs":"group2","IpsecLifetime":86400}
&HealthCheckConfig={"enable":"true","dip":"192.168.10.1","sip":"10.10.1.1","interval":"3","retry":"3"}
&AutoConfigRoute=true
&EnableDpd=true
&EnableNatTraversal=true
&BgpConfig={"EnableBgp":"true","LocalAsn":"45104","TunnelCidr":"169.254.11.0/30","LocalBgpIp":"169.254.11.1"}
&Tags=[{"Key":"TagKey","Value":"TagValue"}]
&Common request parameters
Exemplos de respostas de sucesso
Formato XML
HTTP/1.1 200 OK
Content-Type:application/xml
<CreateVpnConnectionResponse>
<RequestId>082AD562-B8DB-4BB2-861F-DA1FCA01FD76</RequestId>
<VpnConnectionId>vco-bp15oes1py4i6****</VpnConnectionId>
<Name>test</Name>
<CreateTime>1544666102000</CreateTime>
</CreateVpnConnectionResponse>
Formato JSON
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "082AD562-B8DB-4BB2-861F-DA1FCA01FD76",
"VpnConnectionId" : "vco-bp15oes1py4i6****",
"Name" : "test",
"CreateTime" : 1544666102000
}
Códigos de erro
|
HttpCode |
Código de erro |
Mensagem de erro |
Descrição |
|
400 |
Resource.QuotaFull |
The quota of resource is full |
A cota de recursos foi atingida. |
|
400 |
InvalidVpnConnection.AlreadyExists |
Vpn connection already exists. |
A conexão IPsec-VPN já existe. |
|
400 |
VpnGateway.Configuring |
The specified service is configuring. |
Operação não permitida enquanto o serviço especificado está em configuração. Tente novamente mais tarde. |
|
400 |
VpnGateway.FinancialLocked |
The specified service is financial locked. |
Serviço suspenso devido a pagamentos pendentes. Recarregue sua conta primeiro. |
|
400 |
VpnGateway.IpsecVpnDisabled |
The vpn gateway does not enable IPSec VPN. |
O recurso IPsec-VPN não está habilitado neste VPN gateway. |
|
400 |
VpnRouteEntry.AlreadyExists |
The specified route entry is already exist. |
A rota especificada já existe. |
|
400 |
VpnRouteEntry.Conflict |
The specified route entry has conflict. |
A rota indicada entra em conflito com uma rota existente. |
|
400 |
NotSupportVpnConnectionParameter.IpsecPfs |
The specified vpn connection ipsec Ipsec Pfs is not support. |
O parâmetro PFS definido 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. |
Conflito detectado entre a rota e o cliente SSL. |
|
400 |
VpnRouteEntry.BackupRoute |
Validate backup route entry failed. |
Falha na validação das rotas ativa/em standby. |
|
400 |
VpnRouteEntry.InvalidWeight |
Invalid route entry weight value. |
O peso atribuído à rota é inválido. |
|
400 |
InvalidParameter.VpnConnectionName |
The specified vpn connection name is invalid. |
O nome da conexão VPN não atende aos requisitos. |
|
400 |
OperationUnsupported.SetDPD |
Current version of the VPN does not support setting DPD. |
A versão atual do VPN gateway não suporta a configuração de DPD. |
|
400 |
OperationUnsupported.SetNatTraversal |
Current version of the VPN does not support setting NAT traversal. |
A versão atual do VPN gateway não suporta travessia de nat. |
|
400 |
QuotaExceeded.PolicyBasedRoute |
The maximum number of policy-based routes is exceeded. Existing routes: %s. Routes to be created: %s. Maximum routes: %s. |
Limite de rotas baseadas em política atingido. Máximo permitido: %s. Rotas existentes: %s. Tentativa de criação: %s rotas. |
|
400 |
MissingParameter.TunnelCidr |
The parameter TunnelCidr is mandatory when BGP is enabled. |
É obrigatório especificar o bloco CIDR do túnel ao habilitar o BGP. |
|
400 |
OperationUnsupported.EnableBgp |
Current version of the VPN does not support enable BGP. |
A versão atual do VPN gateway não oferece suporte a BGP. |
|
400 |
MissingParam.CustomerGatewayAsn |
Asn of customer gateway is mandatory when BGP is enabled. |
O ASN do customer gateway é obrigatório quando o BGP está ativado. |
|
400 |
IllegalParam.LocalAsn |
The specified LocalAsn is invalid. |
O ASN local informado é inválido. |
|
400 |
IllegalParam.BgpConfig |
The specified BgpConfig is invalid. |
Configuração BGP inválida. |
|
400 |
IllegalParam.EnableBgp |
VPN connection must enable BGP when VPN gateway has enabled BGP. |
A conexão IPsec-VPN deve utilizar BGP se o VPN gateway já tiver o BGP habilitado. |
|
400 |
IllegalParam.TunnelCidr |
The specified TunnelCidr is invalid. |
O valor fornecido para TunnelCidr é inválido. |
|
400 |
InvalidLocalBgpIp.Malformed |
The specified LocalBgpIp is malformed. |
O endereço IP BGP local apresenta formato incorreto. |
|
400 |
IllegalParam.LocalBgpIp |
The specified LocalBgpIp is invalid. |
Endereço IP BGP local inválido. |
|
400 |
IllegalParam.LocalSubnet |
The specified "LocalSubnet" (%s) is invalid. |
Valor inválido para LocalSubnet (%s). |
|
400 |
IllegalParam.RemoteSubnet |
The specified "RemoteSubnet" (%s) is invalid. |
Valor inválido para RemoteSubnet. |
|
400 |
OperationFailed.MissCertificate |
The VPN gateway has not associated any certificates. |
Nenhum certificado associado ao VPN gateway. |
|
400 |
MissingParam.RemoteId |
The remote ID is mandatory when creating national standard VPN connection. |
ID remoto não especificado. Este parâmetro é obrigatório para conexões VPN com criptografia SM. |
|
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. |
A VPC do VPN gateway está vinculada a uma instância Cloud Enterprise Network (CEN) no modo FULL, impedindo a ativação do BGP. |
|
400 |
CustomerGateway.ConflictRouteEntry |
The specified customer gateway has conflict with route entry. |
O customer gateway especificado conflita com as rotas atuais. |
|
400 |
VpnTask.CONFLICT |
Vpn task has conflict. |
Conflito na operação VPN. Tente novamente mais tarde. |
|
400 |
Forbidden.TagKey.Duplicated |
The specified tag key already exists. |
Chaves de tag duplicadas nos recursos. |
|
400 |
SizeLimitExceeded.TagNum |
The maximum number of tags is exceeded. |
Quantidade máxima de tags atingida. |
|
400 |
InvalidParameter.TagValue |
The specified parameter TagValue is invalid. |
Valor da tag inválido. |
|
400 |
InvalidParameter.TagKey |
The specified parameter TagKey is invalid. |
Chave da tag inválida. |
|
400 |
Duplicated.TagKey |
The specified parameter TagKey is duplicated. |
A chave da tag já existe. |
|
400 |
InternalError |
The request processing has failed due to some unknown error, exception or failure. |
Ocorreu um erro interno. |
|
400 |
InvalidTunnelCidr.Malformed |
The specified TunnelCidr is malformed. |
Formato inválido para o bloco CIDR do túnel. |
|
400 |
VpnConnectionParamInvalid.SameVpnAndCgwDifferentIkeConfigs |
IPSec connections associated with the same user gateway and VPN gateway should have the same pre-shared key and IKE configuration. |
Conexões IPsec-VPN associadas ao mesmo VPN gateway e customer gateway devem compartilhar a mesma chave pré-compartilhada e configuração IKE. |
|
400 |
VpnConnectionParamInvalid.SameVpnAndCgwTrafficSelectorOverlap |
Traffic selectors of IPSec connections associated with the same user gateway and VPN gateway should not overlap. |
Os fluxos de dados protegidos de conexões IPsec-VPN ligadas ao mesmo VPN gateway e customer gateway não podem se sobrepor. |
|
403 |
Forbbiden.SubUser |
User not authorized to operate on the specified resource as your account is created by another user. |
Você não tem autorização para operar neste recurso. Solicite as permissões necessárias e tente novamente. |
|
403 |
Forbidden |
User not authorized to operate on the specified resource. |
Sem permissão para executar esta operação no recurso indicado. Solicite acesso e tente novamente. |
|
404 |
InvalidCustomerGatewayInstanceId.NotFound |
The specified customer gateway instance id does not exist. |
Customer gateway não encontrado. |
|
404 |
InvalidVpnGatewayInstanceId.NotFound |
The specified vpn gateway instance id does not exist. |
VPN gateway não encontrado. |
Para obter uma lista completa de códigos de erro, consulte Códigos de erro do serviço.