CreateTransitRouterVbrAttachment - Cloud Enterprise Network: Central de Documentação do Alibaba Cloud

Cria uma conexão VBR em um transit router da Enterprise Edition. Você pode invocar a operação CreateTransitRouterVbrAttachment para conectar uma instância de rede de virtual border router (VBR) a uma instância de transit router que pode encaminhar e executar roteamento na mesma região. Após o estabelecimento da conexão, o transit router ativa o peering de rede privada.

Descrição da operação

Para obter informações sobre as regiões e zonas compatíveis com os transit routers da Enterprise Edition, consulte O que é o Cloud Enterprise Network?.
Você pode criar uma conexão VBR em um transit router da Enterprise Edition usando um dos seguintes métodos:
- Se você já criou uma instância de transit router da Enterprise Edition que pode encaminhar e executar roteamento na região de destino, poderá criar uma conexão VBR especificando VbrId, RegionId e TransitRouterId.
- Se você não criou uma instância de transit router da Enterprise Edition na região de destino, poderá criar uma conexão VBR especificando VbrId, CenId e RegionId. O sistema realiza a criação automática de uma instância de transit router da Enterprise Edition que pode encaminhar e executar roteamento quando a conexão VBR é criada.
CreateTransitRouterVbrAttachment é uma operação assíncrona. O sistema retorna um ID de conexão VBR, mas a conexão VBR ainda não foi criada e a tarefa de criação ainda está em execução em segundo plano. Você pode chamar ListTransitRouterVbrAttachments para consultar o status da conexão VBR.
- Se a conexão VBR estiver no estado Attaching, a conexão VBR está sendo criada. Nesse estado, você pode apenas consultar a conexão VBR e não pode realizar outras operações.
- Se a conexão VBR estiver no estado Attached, a conexão VBR foi criada.
A conta Alibaba Cloud à qual o transit router pertence e a conta Alibaba Cloud à qual o VBR pertence devem pertencer à mesma empresa.
Os transit routers suportam a conexão de VBRs na mesma conta e entre contas. Antes de criar uma conexão VBR entre contas, obtenha autorização para o VBR entre contas. Para obter mais informações, consulte Conceder permissões em instâncias de rede entre contas.
Após a criação de uma conexão VBR, a conexão VBR não estabelece relações de aprendizado de rotas ou encaminhamento associado com nenhuma tabela de rotas do transit router por padrão.

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

cen:CreateTransitRouterVbrAttachment

create

CenInstance.

acs:cen:*:{#accountId}:ceninstance/{#ceninstanceId}

TransitRouter.

acs:cen:*:{#accountId}:centransitrouter/{#TransitRouterId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ClientToken	string	Não	O token de cliente usado para garantir a idempotência da solicitação. Você pode usar o cliente para gerar o valor, mas deve garantir que o valor 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 é exclusivo.	02fb3da4-130e-11e9-8e44-001****
CenId	string	Não	O ID da instância do Cloud Enterprise Network (CEN). Este parâmetro é obrigatório quando TransitRouterId não é especificado. O sistema realiza a criação automática de uma instância de transit router da Enterprise Edition que pode encaminhar e executar roteamento na região especificada por RegionId.	cen-j3jzhw1zpau2km****
TransitRouterId	string	Não	O ID da instância de transit router da Enterprise Edition. Este parâmetro é obrigatório quando CenId não é especificado. É usado para criar uma conexão VBR em uma instância de transit router da Enterprise Edition existente que pode encaminhar e executar roteamento.	tr-bp1su1ytdxtataupl****
RegionId	string	Não	O ID da região do VBR. Este parâmetro é obrigatório e deve ser usado em combinação com VbrId e CenId ou TransitRouterId. Você pode chamar DescribeRegions para consultar os IDs de região.	cn-hangzhou
TransitRouterAttachmentName	string	Não	O nome da conexão VBR. O nome pode estar vazio ou ter de 1 a 128 caracteres de comprimento, e não pode começar com http:// ou https://.	testname
TransitRouterAttachmentDescription	string	Não	A descrição da conexão VBR. A descrição pode estar vazia ou ter de 1 a 256 caracteres de comprimento, e não pode começar com http:// ou https://.	testdesc
VbrId	string	Sim	O ID da instância VBR.	vbr-bp1svadp4lq38janc****
VbrOwnerId	integer	Não	O ID da conta Alibaba Cloud à qual a instância VBR pertence. O valor padrão é o ID da conta Alibaba Cloud do login atual. Nota Este parâmetro é obrigatório se você deseja carregar uma instância de rede entre contas.	1250123456123456
AutoPublishRouteEnabled	boolean	Não	Especifica se a instância de transit router da Enterprise Edition que pode encaminhar tráfego deve publicar automaticamente entradas de rota e informações de roteamento para a instância VBR. Valores válidos: false (padrão): não. true: sim.	false
DryRun	boolean	Não	Especifica se deve ser realizado um dry run na solicitação, incluindo verificações de permissão e status da instância. Valores válidos: false (padrão): envia uma solicitação normal e cria a conexão VBR após a aprovação na verificação. true: envia uma solicitação de verificação e realiza apenas a verificação sem criar a conexão VBR. Os itens de verificação incluem se os parâmetros obrigatórios foram especificados e o formato da solicitação. Se a verificação falhar, um erro será retornado. Se a verificação for aprovada, o ID da solicitação será retornado.	false
Tag	array<object>	Não	As informações da tag. Você pode especificar até 20 tags por vez.
	object	Não
Key	string	Não	A chave da tag do recurso. A chave da tag não pode ser uma string vazia. Pode ter até 64 caracteres de comprimento e não pode começar com `aliyun` ou `acs:`, nem conter `http://` ou `https://`. Você pode especificar até 20 chaves de tag por vez.	TagKey
Value	string	Não	O valor da tag do recurso. O valor da tag não pode estar vazio. Pode ter até 128 caracteres de comprimento e não pode começar com aliyun ou acs:, nem conter http:// ou https://. Cada chave de tag corresponde a um valor de tag. Você pode especificar até 20 valores de tag por vez.	TagValue

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	A estrutura da resposta.
TransitRouterAttachmentId	string	O ID da conexão VBR.	tr-attach-ia340z7xis7t5s****
RequestId	string	O ID da solicitação.	C087A369-82B9-43EF-91F4-4B63A9C6E6B6

Exemplos

Resposta de sucesso

JSON formato

{
  "TransitRouterAttachmentId": "tr-attach-ia340z7xis7t5s****",
  "RequestId": "C087A369-82B9-43EF-91F4-4B63A9C6E6B6"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	NoPermission.AliyunServiceRolePolicyForCEN	You are not authorized to create the service linked role. Role Name: AliyunServiceRolePolicyForCEN. Service Name: cen.aliyuncs.com. Make sure that the user has been granted the ram:CreateServiceLinkedRole permission.	Você não tem permissão para criar a função vinculada ao serviço. Nome da função: AliyunServiceRolePolicyForCEN. Nome do serviço: cen.aliyuncs.com. Certifique-se de que a permissão ram:CreateServiceLinkedRole foi concedida ao usuário atual.
400	OperationUnsupported.TransitRouterRegionId	The specified TransitRouterRegion does not support the operation.
400	InvalidCenId.NotFound	CenId is not found.	A instância CEN não existe.
400	InvalidStatus.ResourceStatus	The resource is not in a valid state for the attachment operation.	O status atual do recurso não suporta esta operação. Tente novamente mais tarde.
400	InvalidTransitRouterId.NotFound	TransitRouterId is not found.	O transit router correspondente não foi encontrado.
400	Forbbiden.TransitRouterServiceNotOpen	The user has not open transit router service.	O serviço de transit router não está ativado. Ative o serviço e tente novamente.
400	OperationUnsupported.TransitRouterType	The specified TransitRouterType does not support the operation.	O tipo atual de transit router não suporta esta operação.
400	MissingParam.CenIdOrRegionId	Either CenId or RegionId must be specified.	CenId ou RegionId é um parâmetro obrigatório.
400	IncorrectStatus.Vpc	The resource is not in a valid state for the attachment operation.	O estado atual da VPC não suporta esta operação. Tente novamente mais tarde.
400	Forbidden.VbrDeviceModel	Attach VBR on some access device models are forbidden.	O modo de acesso atual do VBR não suporta esta operação.
400	IllegalParam.AssociateRouteTableId	The specified AssociateRouteTableId is illegal.	O AssociateRouteTableId especificado na solicitação é inválido.
400	Forbbiden.AttachChildInstanceAcrossBid	Operation is invalid, please apply for cross-bid attaching.
400	IllegalParam.RegionId	RegionId is illegal.	O parâmetro Region especificado é inválido.
400	OperationUnsupported.CenFullLevel	CEN full level does not support TransitRouter	As instâncias CEN do tipo Full não oferecem suporte à criação de transit routers da Enterprise Edition.
400	OperationUnsupported.VbrAttachment	This region not support vbr attachment.	Esta região não oferece suporte ao carregamento de anexos de VBR.
400	InvalidOperation.CenInstanceStatus	The CEN instance is not in a valid state for the operation.
400	OperationUnsupported.CloudBoxVbrNotSupport	Cloud Box Vbr does not support.	As instâncias CloudBox não podem ser anexadas.
400	IncorrectStatus.VbrResource	The resource is not in a valid state for the attachment operation.	O recurso VBR não está em um estado estável. Aguarde até que as operações relacionadas ao VBR atual sejam concluídas e tente novamente.
400	IncorrectStatus.TransitRouter	The status of TransitRouter is incorrect.	O status atual do transit router não suporta esta operação. Tente novamente mais tarde.
400	QuotaExceeded.CenQuotaVbrAttachPerTransitRouter	The maximum number of VBR attachment per Transit Router is exceeded.	O número de roteadores de borda virtual (VBRs) que podem ser conectados a cada roteador de trânsito excedeu o limite. Abra um ticket para aumentar a cota.
400	QuotaFull.ChildInstanceRelatedCen	The childinstance has exceed the quota of the times that a childinstance can be attached as an attachment.	O número de instâncias CEN associadas a esta instância atingiu o limite superior. A instância não pode ser carregada.
400	Forbidden.ResourceOwnerTransitRouterServiceNotOpen	The resource owner user has not opened transit router service.	O serviço de transit router da conta proprietária do recurso não está ativado. Notifique o proprietário da conta para ativar o serviço e tente novamente.
400	InvalidOperation.VbrAttachedToEcr	VBR has alreay attached to ECR.	O VBR já está associado a um ECR.
400	Forbidden.ResourceOwnerTransitRouterServiceExpired	The transit router service of the account to which the resource belongs has been suspended due to arrears. Please notify the other party to renew the service and try again.	O serviço de transit router da conta proprietária do recurso foi suspenso devido a um pagamento em atraso. Notifique o proprietário da conta para renovar o serviço e tente novamente.
400	Forbidden.TransitRouterServiceExpired	The transit router service is out of service.	O serviço de transit router foi suspenso devido a um pagamento em atraso. Renove o serviço e tente novamente.
400	InvalidParameter	Invalid parameter.	O parâmetro é inválido.
400	Unauthorized	The AccessKeyId is unauthorized.	Você não tem permissões suficientes para realizar esta operação. Abra um ticket para obter assistência.
400	InvalidParameter.ResourceType	The specified parameter ResourceType is invalid.	O ResourceType especificado é inválido.
400	InvalidParameter.TagValue	The specified parameter TagValue is invalid.	O parâmetro Tag Value especificado é inválido.
400	InvalidParameter.CenBandwidthPackageId	The specified parameter CenBandwidthPackageId is invalid.	O parâmetro CenBandwidthPackageId especificado é inválido.
400	InvalidParameter.CenId	The specified parameter CenId is invalid.	O parâmetro CenId especificado é inválido.
400	InvalidParameter.TransitRouterId	The specified parameter TransitRouterId is invalid.	O parâmetro TransitRouterId especificado é inválido.
400	InvalidParameter.AssociateRouteTableId	The specified parameter AssociateRouteTableId is invalid.	O parâmetro AssociateRouteTableId é inválido.
403	Forbidden.VbrDeviceModel	The attached VBR on some access device models are not supported. Please submit a ticket to continue using this VBR on CEN.	O modo de acesso atual do VBR não suporta esta operação.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.