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

Observações de uso

Para obter mais informações sobre as regiões e zonas compatíveis com transit routers Enterprise Edition, consulte O que é o CEN?.
Use um dos métodos a seguir para criar uma conexão VBR em um transit router Enterprise Edition:
- Se já existir um transit router Enterprise Edition na região onde você deseja criar a conexão VBR, defina os parâmetros VbrId e TransitRouterId.
- Se não houver um transit router Enterprise Edition na região desejada, defina os parâmetros VbrId,CenId e RegionId. O sistema cria automaticamente um transit router Enterprise Edition na região especificada.
A operação CreateTransitRouterVbrAttachment é assíncrona. Após o envio da solicitação, o sistema retorna o ID da conexão VBR, mas a operação continua em execução em segundo plano. Chame a operação ListTransitRouterVbrAttachments para consultar o status da conexão VBR.
- Se o VBR estiver no estado Attaching, a conexão está sendo criada. É possível consultar a conexão VBR, mas não é permitido executar outras operações.
- O estado Attached indica que a conexão VBR foi criada.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. A ferramenta gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	CreateTransitRouterVbrAttachment	Operação a ser executada. Defina o valor como CreateTransitRouterVbrAttachment.
ClientToken	String	Não	02fb3da4-130e-11e9-8e44-001****	Token do cliente usado para garantir a idempotência da solicitação. Gere o valor por meio do cliente e garanta que seja único entre diferentes solicitações. O ClientToken aceita apenas caracteres ASCII. Nota Se este parâmetro não for definido, o ClientToken assumirá o valor de RequestId. O valor de RequestId pode variar a cada solicitação de API.
CenId	String	Não	cen-j3jzhw1zpau2km****	ID da instância do Cloud Enterprise Network (CEN).
TransitRouterId	String	Não	tr-bp1su1ytdxtataupl****	ID do transit router Enterprise Edition.
RegionId	String	Não	cn-hangzhou	ID da região onde o VBR está implantado. Chame a operação DescribeRegions para obter a lista mais recente de regiões.
TransitRouterAttachmentName	String	Não	testname	Nome da conexão VBR. Deve ter de 2 a 128 caracteres e pode conter letras, dígitos, sublinhados (_) e hifens (-). Deve começar com uma letra.
TransitRouterAttachmentDescription	String	Não	testdesc	Descrição da conexão VBR. Deve ter de 2 a 256 caracteres. Precisa começar com uma letra e não pode iniciar com `http://` ou `https://`.
VbrId	String	Sim	vbr-bp1svadp4lq38janc****	ID do VBR.
VbrOwnerId	Long	Não	1250123456123456	ID da conta Alibaba Cloud proprietária do VBR. O valor padrão é o ID da conta Alibaba Cloud atual. Nota Este parâmetro é obrigatório para conectar-se a uma instância de rede pertencente a outra conta.
AutoPublishRouteEnabled	Boolean	Não	false	Define se o transit router Enterprise Edition anunciará rotas automaticamente para o VBR. Valores válidos: false (padrão): não. true: sim.
DryRun	Boolean	Não	false	Indica se deve ser feita uma verificação prévia de permissões e status da instância. Valores válidos: false (padrão): envia a solicitação. Se aprovada na verificação prévia, o sistema cria a conexão VBR. true: envia apenas uma solicitação de verificação prévia. Nenhuma conexão VBR é criada após a aprovação. O sistema valida os parâmetros obrigatórios e a sintaxe da solicitação. Em caso de falha, o sistema retorna uma mensagem de erro. Se a verificação for bem-sucedida, o sistema retorna o ID da solicitação.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
TransitRouterAttachmentId	String	tr-attach-ia340z7xis7t5s****	ID da conexão VBR.
RequestId	String	C087A369-82B9-43EF-91F4-4B63A9C6E6B6	ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=CreateTransitRouterVbrAttachment
&ClientToken=02fb3da4-130e-11e9-8e44-001****
&CenId=cen-j3jzhw1zpau2km****
&TransitRouterId=tr-bp1su1ytdxtataupl****
&RegionId=cn-hangzhou
&TransitRouterAttachmentName=testname
&TransitRouterAttachmentDescription=testdesc
&VbrId=vbr-bp1svadp4lq38janc****
&VbrOwnerId=1250123456123456
&AutoPublishRouteEnabled=false
&DryRun=false
&Common request parameters

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateTransitRouterVbrAttachmentResponse>
    <TransitRouterAttachmentId>tr-attach-ia340z7xis7t5s****</TransitRouterAttachmentId>
    <RequestId>C087A369-82B9-43EF-91F4-4B63A9C6E6B6</RequestId>
</CreateTransitRouterVbrAttachmentResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

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

Códigos de erro

HttpCode	Códigos 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.	Erro retornado quando falta autorização para criar a função vinculada ao serviço AliyunServiceRolePolicyForCEN para o serviço cen.aliyuncs.com. Adquira a permissão ram:CreateServiceLinkedRole antes de executar a operação.
400	OperationUnsupported.TransitRouterRegionId	The specified TransitRouterRegion does not support the operation.	Erro retornado porque a região especificada não oferece suporte à operação.
400	InvalidCenId.NotFound	CenId is not found.	Erro retornado porque a instância CEN especificada não existe.
400	InvalidTransitRouterId.NotFound	TransitRouterId is not found.	Erro retornado porque o ID do transit router é inválido.

Para obter uma lista de códigos de erro, visite o API Error Center.