Todos os produtos
Search
Central de documentação

Elastic Compute Service:CreateVirtualBorderRouter

Última atualização: Jun 26, 2026

CreateVirtualBorderRouter.

Nota

Esta API foi descontinuada. Recomendamos migrar para Vpc(2016-04-28) - CreateVirtualBorderRouter para funcionalidade aprimorada e suporte contínuo. Embora a API descontinuada permaneça temporariamente acessível, nenhuma atualização ou correção de bugs será fornecida.

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

create

*全部资源

*

Nenhuma Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

RegionId

string

Sim

O ID da região onde o Virtual Border Router (VBR) está localizado.

Você pode chamar a operação DescribeRegions para obter a lista mais recente de regiões.

PhysicalConnectionId

string

Sim

O ID da conexão física.

VbrOwnerId

integer

Não

O ID da conta Alibaba Cloud que possui o VBR. Especifique este parâmetro ao criar um VBR para outra conta.

VlanId

integer

Sim

O ID da VLAN do VBR.

Valores válidos: 0 a 4095.

Um valor 0 indica que o VBR está conectado à conexão física no modo de roteador da Camada 3.

CircuitCode

string

Não

O código do circuito da conexão física. Este código é fornecido pelo seu provedor de conectividade.

LocalGatewayIp

string

Não

O endereço IP do gateway do VBR na Alibaba Cloud.

PeerGatewayIp

string

Não

O endereço IP do gateway no seu data center local.

PeeringSubnetMask

string

Não

A máscara de sub-rede de peering para os endereços IP do gateway local e do gateway par.

Description

string

Não

A descrição do VBR.

A descrição deve ter de 2 a 256 caracteres e não pode começar com http:// ou https://.

Name

string

Não

O nome do VBR.

O nome deve ter de 2 a 128 caracteres, começar com uma letra e pode conter apenas letras, dígitos, pontos (.), sublinhados (_) e hifens (-).

ClientToken

string

Sim

Um token de cliente para garantir que a solicitação seja idempotente.

Você pode gerar este token no seu cliente, mas deve garantir que ele seja exclusivo para cada solicitação. O token pode conter apenas caracteres ASCII e não pode ter mais de 64 caracteres.

UserCidr

string

Não

Um token de cliente para garantir que a solicitação seja idempotente.

Você pode gerar este token no seu cliente, mas deve garantir que ele seja exclusivo para cada solicitação. O token pode conter apenas caracteres ASCII e não pode ter mais de 64 caracteres.

Não

O bloco CIDR da sua rede local. Necessário quando o VBR está conectado a uma instância do Cloud Enterprise Network (CEN).

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Os dados da resposta.

VbrId

string

O ID do Virtual Border Router.

RequestId

string

O ID da solicitação.

Exemplos

Resposta de sucesso

JSON formato

{
  "VbrId": "",
  "RequestId": ""
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 InvalidPhysicalConnectionId.NotFound The specified PhysicalConnectionId is not found.
400 InvalidVlanId.Used The specified VlanId has been used.
400 MissingParameter The input parameter 'PhysicalConnectionId' that is mandatory for processing this request is not supplied.
400 InvalidPhysicalConnectionId.NotEnabled The specified PhysicalConnectionId is not in Enabled state.
400 InvalidVlanId.Malformed The specified VlanId is not valid.
400 InvalidCircuitCode.Malformed The specified CircuitCode is not valid.
400 InvalidLocalGatewayIp.Malformed The specified LocalGatewayIp is not valid.
400 InvalidPeeringSubnetMask.Malformed The specified PeeringSubnetMask is not valid.
400 InvalidName.Malformed The specified Name is not valid.
400 InvalidDescription.Malformed The specifid Description is not valid.
400 QuotaExceeded.vbrPerpConn Virtual boarder router per PhysicalConnection quota exceed.
400 QuotaExceeded.freevbr Free virtual boarder router quota exceed.
400 InvalidIp.NotSameSubnet Local gateway ip and peer gateway ip are not in the same subnet.
400 TaskConflict The operation is too frequent, please wait a moment and try again.
400 QuotaExceeded.CrossUserVBRPerUser Cross virtual boarder router per user quota exceed.
400 OperationFailed.VlanIdInUse Operation failed because vlanId is in use.
403 Forbidden.LocalGatewayIpNotAllowedByCaller The caller is not allowed to specify the LocalGatewayIp parameter.
403 Forbidden.PeerGatewayIpNotAllowedByCaller The caller is not allowed to specify the PeerGatewayIp parameter.
403 Forbidden.PeeringSubnetMaskNotAllowedByCaller The caller is not allowed to specify the PeeringSubnetMask parameter.
403 Forbidden.NameNotAllowedByCaller The caller is not allowed to specify the Name parameter.
403 Forbidden.DescriptionNotAllowedByCaller The caller is not allowed to specify the Description parameter.
404 InvalidRegionId.NotFound The specified RegionId is not found.
404 InvalidVbrOwnerId.NotFound The specified VbrOwnerId is not valid.
404 OperationFailed.AccessDeviceDisabled Access device is disabled and can not create vbr.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.