CreateVirtualBorderRouter - Express Connect: Central de Documentação do Alibaba Cloud

Cria uma instância de Virtual Border Router (VBR) chamando a operação CreateVirtualBorderRouter.

Descrição da operação

Após a criação de uma instância de VBR, o status da instância de VBR é active.

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

*PhysicalConnection.

acs:vpc:{#regionId}:{#accountId}:physicalconnection/{#PhysicalConnectionId}

*VirtualBorderRouter.

acs:vpc:{#regionId}:{#AccountId}:virtualborderrouter/*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região do circuito do Express Connect. Você pode chamar a operação DescribeRegions para consultar o ID da região.	cn-shanghai
PhysicalConnectionId	string	Sim	O ID da instância do circuito do Express Connect. Você pode criar uma instância de VBR para um circuito dedicado do Express Connect ou para circuitos compartilhados do Express Connect.	pc-2zextbehcx****
VbrOwnerId	integer	Não	O ID da conta do proprietário da instância de VBR. O valor padrão é o ID da conta Alibaba Cloud usado para fazer login.	168811111****
VlanId	integer	Sim	O ID da VLAN da instância de VBR. Valores válidos: 0 a 2999. Nota Somente o proprietário do circuito do Express Connect pode especificar este parâmetro. Os IDs da VLAN de duas instâncias de VBR no mesmo circuito do Express Connect devem ser diferentes.	0
CircuitCode	string	Não	O código do circuito fornecido pela operadora para o circuito do Express Connect. Nota Somente o proprietário do circuito do Express Connect pode especificar este parâmetro.	longtel001
LocalGatewayIp	string	Não	O endereço IP do lado da Alibaba Cloud da instância de VBR. Somente o proprietário do VBR pode especificar ou modificar esta propriedade. Este parâmetro é obrigatório quando você cria uma instância de VBR para o proprietário do circuito do Express Connect.	192.168.XX.XX
PeerGatewayIp	string	Não	O endereço IP do lado do cliente da instância de VBR. Somente o proprietário do VBR pode especificar ou modificar esta propriedade. Este parâmetro é obrigatório quando você cria uma instância de VBR para o proprietário do circuito do Express Connect.	116.62.XX.XX
PeeringSubnetMask	string	Não	A máscara de sub-rede para os endereços IP do lado da Alibaba Cloud e do lado do cliente da instância de VBR. Os dois endereços IP devem estar na mesma sub-rede.	255.255.255.252
Description	string	Não	A descrição da instância de VBR. A descrição deve ter de 2 a 256 caracteres e deve começar com uma letra ou um caractere chinês. Não pode começar com `http://` ou `https://`.	desc
Name	string	Não	O nome da instância de VBR. O nome deve ter de 2 a 128 caracteres e deve começar com uma letra ou um caractere chinês. Pode conter dígitos, sublinhados (_) e hifens (-). Não pode começar com `http://` ou `https://`.	test
ClientToken	string	Não	O token de cliente usado para garantir a idempotência da solicitação. O cliente gera o valor deste parâmetro. Certifique-se de que o valor seja exclusivo entre diferentes solicitações. 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 variar para cada solicitação de API.	123e4567-e89b-12d3-a456-426655440000
LocalIpv6GatewayIp	string	Não	O endereço IPv6 do lado da Alibaba Cloud da instância de VBR. Somente o proprietário do VBR pode especificar ou modificar esta propriedade. Este parâmetro é obrigatório quando você cria uma instância de VBR para o proprietário do circuito do Express Connect.	2001:XXXX:3c4d:0015:0000:0000:0000:1a2b
PeerIpv6GatewayIp	string	Não	O endereço IPv6 do lado do cliente da instância de VBR. Somente o proprietário do VBR pode especificar ou modificar esta propriedade. Este parâmetro é obrigatório quando você cria uma instância de VBR para o proprietário do circuito do Express Connect.	2001:XXXX:4:4:4:4:4:4
PeeringIpv6SubnetMask	string	Não	A máscara de sub-rede para os endereços IPv6 do lado da Alibaba Cloud e do lado do cliente da instância de VBR. Os dois endereços IPv6 devem estar na mesma sub-rede.	2408:4004:cc:400::/56
EnableIpv6	boolean	Não	Especifica se o IPv6 deve ser ativado. Valores válidos: true: Ativado. false (padrão): Desativado.	true
Bandwidth	integer	Não	O valor da largura de banda da instância de VBR. Unidade: Mbit/s. Ao criar uma instância de VBR para um circuito dedicado do Express Connect, os valores válidos são 50, 100, 200, 300, 400, 500, 1000, 2048, 5120, 8192, 10240, 20480, 40960, 50120, 61440 e 102400. Ao criar uma instância de VBR para circuitos compartilhados do Express Connect, não é necessário configurar este parâmetro. A largura de banda do VBR é a largura de banda dos circuitos compartilhados do Express Connect que foi especificada nas Configurações quando os circuitos compartilhados do Express Connect foram criados.	100
ResourceGroupId	string	Não	O ID do grupo de recursos. Para obter mais informações sobre grupos de recursos, consulte O que é um grupo de recursos?.	rg-acfmxazb4ph6aiy****
Tags	array<object>	Não	As tags do recurso.
	object	Não	A tag.
Key	string	Não	A chave da tag do recurso. Você deve especificar pelo menos 1 chave de tag e pode especificar no máximo 20 chaves de tag. A chave da tag não pode ser uma string vazia. Uma chave de tag pode ter até 128 caracteres. Não pode começar com `aliyun` ou `acs:` e não pode conter `http://` ou `https://`.	FinanceDept
Value	string	Não	O valor da tag do recurso. Você pode especificar no máximo 20 valores de tag. O valor da tag pode ser uma string vazia. O valor da tag pode ter até 128 caracteres. Não pode começar com `aliyun` ou `acs:` e não pode conter `http://` ou `https://`.	FinanceJoshua

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta.
RequestId	string	O ID da solicitação.	4EC47282-1B74-4534-BD0E-403F3EE64CAF
VbrId	string	O ID da instância de VBR.	vbr-bp1jcg5cmxjbl9xgc****

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "4EC47282-1B74-4534-BD0E-403F3EE64CAF",
  "VbrId": "vbr-bp1jcg5cmxjbl9xgc****"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	OperationFailed.PconnAllocateVlan0	Vlan 0 Vbr cannot share the physical connection with another Vbr.	A VLAN 0 no circuito do Express Connect não pode coexistir com outros Virtual Border Routers (VBRs).
400	IllegalParam.IpAddress	The specified IpAddress (%s) is illegal.	O endereço IP é inválido.
400	IllegalParam.CidrBlock	The specified CidrBlock (%s) is illegal.	O bloco CIDR é inválido.
400	InvalidPhysicalConnectionId.NotFound	The specified PhysicalConnectionId is not found.	O ID do circuito do Express Connect especificado não existe.
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.	O PeeringSubnetMask especificado é inválido. Verifique se este parâmetro está correto.
400	InvalidName.Malformed	The specified ?Name? is not valid.
400	InvalidDescription.Malformed	The specifid ?Description? is not valid.	O formato da descrição do recurso especificado é inválido. A descrição deve ter de 2 a 256 caracteres e não pode começar com http:// ou https://.
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.	O endereço IP do gateway local e o endereço IP do gateway par não estão na mesma sub-rede.
400	TaskConflict	The operation is too frequent, please wait a moment and try again.	As operações de EIP são muito frequentes.
400	QuotaExceeded.CrossUserVBRPerUser	Cross virtual boarder router per user quota exceed.	A cota foi excedida.
400	OperationFailed.VlanIdInUse	Operation failed because vlanId is in use.	O ID da VLAN já está em uso.
400	QuotaExceeded.SameAccountVBRPerPconn	Same account virtual boarder router per physicalConnection quota exceed.	A cota de VBR foi excedida.
400	QuotaExceeded.VbrPerPconnPortSpec	Quota exceed for current port spec	A cota foi excedida.
400	QuotaExceeded.VbrPerAccessDevice	Virtual boarder router per access device quota exceed.	A cota de dispositivos foi excedida.
400	OperationUnsupported.IPV6ForThisRegion	This Region do not support IPV6.	A região não oferece suporte a IPv6.
400	VbrBandwidthExceed	VBR bandwidth exceed for this physical connection.	A largura de banda do Virtual Border Router excede o limite do circuito do Express Connect.
400	OperationFailed.PconnExistVlan0Vbr	The physical connection has VLAN 0 VBR. You cannot create another VBR.	Já existe um VBR de VLAN 0 no circuito do Express Connect. Você não pode criar outros VBRs.
400	OperationFailed.Vlan0VbrUnSharePconn	VLAN 0 VBR cannot share the physical connection with another VBR.	Já existe outro VBR de VLAN 0 no circuito do Express Connect. Você não pode criar um VBR de VLAN 0 neste circuito.
400	OperationFailed.PconnTrafficNotEnable	The operation is failed because of PconnTrafficNotEnable.	A operação falhou porque o tráfego de saída não está ativado.
400	ResourceNotEnough.Bandwidth	The specified resource of Bandwidth is not enough.	Recursos de largura de banda insuficientes.
400	OperationUnsupported.VirtualBorderRouterEnableIPv6	The operation failed. The device or region does not support IPv6 functions.	A operação falhou porque o dispositivo ou a região não suporta IPv6.
400	IllegalParam.OwnerAliUid	The param of VbrOwnerId is illegal.	O ID do usuário é um parâmetro inválido.
400	Forbidden.OwnerAliUid	RAM account or Partner account is forbidden to be OwnerAliUid.	O VbrOwnerId é uma conta de usuário do Resource Access Management (RAM) ou uma conta de parceiro, o que não é permitido como conta proprietária do Virtual Border Router (VBR).
400	OperationDenied.VPconn	Vpconn is forbidden to create vbr for another account.	O tipo de Vpconn não suporta esta operação.
400	OperationFailed.NotConsistentWithVpconn	VBR bandwidth is not consistent with vpconn	O valor de largura de banda do VBR não corresponde ao valor de largura de banda dos circuitos compartilhados do Express Connect associados.
400	IllegalParam.Bandwidth	The param of bandwidth is illegal.	O valor de largura de banda especificado é inválido.
400	OperationFailed.VirtualPhysicalConnectionExistVBR	The virtual physical connect has already created another VBR.	Já existe um VBR para a VirtualPhysicalConnection.
400	ResourceNotInResourceGroup	The specified resource is not in the specified ResourceGroup.	O recurso especificado não está no grupo de recursos especificado.
400	IncorrectStatus.VirtualPhysicalConnection	The status of PhysicalConnection [%s] is incorrect.	O status do circuito compartilhado do Express Connect [%s] está incorreto.
400	EcAssociatedQoSPconnNotAllowCreateCrossAccountVbr	The specified Pconn associated with Qos is not allowed to create cross account VBR.Please contact the business manager.	Você não pode criar um Virtual Border Router entre contas em um circuito Express Connect compartilhado que esteja associado a uma política de QoS. Entre em contato com o gerente da sua conta.
400	OperationFailed.VbrBandWidthMust0InVlan0Vbr	The operation is failed because of VbrBandWidthMust0InVlan0Vbr.	A operação falhou. A configuração de limite de largura de banda não é permitida.
400	OperationDenied.PhysicalConnectionNotSupportMPBGPAndMPBGP-v6	The operation is not allowed because this physical connection not support MPBGP and MPBGP-v6.	A operação não é permitida porque a porta física atual não oferece suporte a recursos avançados, como MPBGP e MPBGP-v6.
400	IncorrectBusinessStatus.PhysicalConnection	Invalid physical connection business status.	O status de negócios atual do circuito do Express Connect não oferece suporte a esta operação.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	O processamento da solicitação falhou devido a um erro desconhecido.
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	CROSS_BID.FORBIDDEN	Create VBR across bid is illegal	Conexões Cross-BID não são permitidas.
404	OperationFailed.AccessDeviceDisabled	Access device is disabled and can not create vbr.	O dispositivo de acesso está desativado. O VBR não pode ser criado.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.