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

Observações de uso

Use um dos métodos a seguir para criar uma conexão de VPC em um transit router da Enterprise Edition:
- Se já existir um transit router da Enterprise Edition na região onde você deseja criar a conexão de VPC, defina os parâmetros VpcId, ZoneMappings.N.VSwitchId, ZoneMappings.N.ZoneId e TransitRouterId.
- Se não houver um transit router da Enterprise Edition na região desejada, especifique VpcId, ZoneMappings.N.VSwitchId, ZoneMappings.N.ZoneId, CenId e RegionId. O sistema cria automaticamente um transit router da Enterprise Edition na região especificada durante a criação da conexão de VPC.
A operação CreateTransitRouterVpcAttachment é assíncrona. Após o envio da solicitação, o sistema retorna o id da conexão de VPC, mas a execução continua em segundo plano. Chame a API ListTransitRouterVpcAttachments para consultar o status da conexão.
- Quando a VPC estiver no estado Attaching, a conexão está sendo criada. Nesse estágio, é possível consultar a conexão, mas não é possível realizar outras operações.
- O estado Attached indica que a conexão de VPC foi criada.
Por padrão, o aprendizado de rotas e o encaminhamento associado permanecem desativados entre as tabelas de rotas do transit router e as conexões de VPC.

Pré-requisitos

Antes de chamar esta operação, verifique se os seguintes requisitos foram atendidos:

A VPC deve ter pelo menos um vSwitch implantado nas zonas compatíveis com transit routers da Enterprise Edition. Cada vSwitch precisa ter no mínimo um endereço ip livre. Para mais informações, consulte Regiões e zonas compatíveis com transit routers da Enterprise Edition.
Para conectar-se a uma instância de rede pertencente a outra conta Alibaba Cloud, obtenha primeiro as permissões necessárias dessa conta. Consulte Obter permissões para conectar-se a uma instância de rede de outra conta para mais informações.
Conexões de VPC geram custos. Revise as regras de faturamento antes de criar a conexão. Para mais informações, consulte Faturamento.

Depuração

O OpenAPI Explorer calcula o valor da assinatura automaticamente. Recomendamos chamar esta operação diretamente no OpenAPI Explorer. A ferramenta também gera dinamicamente exemplos de código para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	CreateTransitRouterVpcAttachment	A operação a ser executada. Defina o valor como CreateTransitRouterVpcAttachment.
ClientToken	String	Não	02fb3da4-130e-11e9-8e44-001****	Token de cliente usado para garantir a idempotência da solicitação. Gere esse valor no lado do cliente e garanta que seja único para cada solicitação. O ClientToken aceita apenas caracteres ASCII. Nota Se este parâmetro não for definido, o ClientToken assumirá o valor de RequestId. O RequestId pode variar a cada chamada 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 da Enterprise Edition.
RegionId	String	Não	cn-hangzhou	id da região onde a VPC está implantada. Chame a operação DescribeChildInstanceRegions para obter a lista atualizada de regiões.
TransitRouterAttachmentName	String	Não	testname	Nome da conexão de VPC. Deve ter entre 2 e 128 caracteres, contendo letras, dígitos, sublinhados (_) e hifens (-). Deve começar com uma letra.
TransitRouterAttachmentDescription	String	Não	testname	Descrição da conexão de VPC. Deve ter entre 2 e 256 caracteres. A descrição deve começar com uma letra e não pode iniciar com `http://` ou `https://`.
VpcId	String	Sim	vpc-bp1kbjcre9vtsebo1****	id da VPC.
VpcOwnerId	Long	Não	1250123456123456	id da conta Alibaba Cloud proprietária da VPC. O valor padrão corresponde ao id da conta atual. Nota Este parâmetro é obrigatório ao conectar-se a uma instância de rede de outra conta.
ChargeType	String	Não	POSTPAY	Método de faturamento. Valor padrão: POSTPAY, referente ao pagamento conforme o uso.
DryRun	Boolean	Não	false	Define se a solicitação será apenas validada sem executar a operação real. O sistema verifica permissões e o status das instâncias especificadas. Valores possíveis: false (padrão): envia a solicitação normalmente. Se a pré-verificação for aprovada, a conexão de VPC é criada. true: realiza apenas a pré-verificação, sem criar a conexão. O sistema valida a presença dos parâmetros obrigatórios e a sintaxe da solicitação. Em caso de falha, o sistema retorna uma mensagem de erro. Se tudo estiver correto, o sistema retorna o código de erro `DryRunOperation`.
ZoneMappings.N.VSwitchId	String	Sim	vsw-bp1a214sbus8z3b54****	Selecione um vSwitch implantado em uma zona compatível com transit routers da Enterprise Edition. É possível especificar vSwitches para até 10 zonas por chamada.
ZoneMappings.N.ZoneId	String	Sim	cn-hangzhou-h	id da zona compatível com transit routers da Enterprise Edition. Use a operação DescribeZones para listar os ids das zonas disponíveis. O limite é de 10 zonas por chamada.
Tag.N.Key	String	Não	tagtest	Chaves das tags dos recursos. As chaves não podem ser strings vazias. Devem ter no máximo 64 caracteres e não podem começar com `acs:` ou `aliyun`. Também não devem conter `http://` ou `https://`. Limite de 20 chaves de tag.
Tag.N.Value	String	Não	tagtest	Valores das tags dos recursos. Os valores podem ter de 0 a 128 caracteres. Não podem começar com `aliyun` ou `acs:`, nem conter `http://` ou `https://`. Cada chave de tag possui um valor exclusivo. É permitido especificar até 20 valores de tag por chamada.

Parâmetros de resposta

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

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=CreateTransitRouterVpcAttachment
&ClientToken=02fb3da4-130e-11e9-8e44-001****
&CenId=cen-j3jzhw1zpau2km****
&TransitRouterId=tr-bp1su1ytdxtataupl****
&RegionId=cn-hangzhou
&TransitRouterAttachmentName=testname
&TransitRouterAttachmentDescription=testname
&VpcId=vpc-bp1kbjcre9vtsebo1****
&VpcOwnerId=1250123456123456
&ChargeType=POSTPAY
&DryRun=false
&ZoneMappings=[{"VSwitchId":"vsw-bp1a214sbus8z3b54****","ZoneId":"cn-hangzhou-h"}]
&Tag=[{"Key":"tagtest","Value":"tagtest"}]
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

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

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ódigo de erro	Mensagem de erro	Descrição
400	OperationUnsupported.TransitRouterRegionId	The specified TransitRouterRegion does not support the operation.	A região especificada não oferece suporte a esta operação.
400	NoPermission.AliyunServiceRoleForCEN	You are not authorized to create the service linked role. Role Name: AliyunServiceRoleForCEN. Service Name: cen.aliyuncs.com. Make sure that the user has been granted the ram:CreateServiceLinkedRole permission.	Falta autorização para criar a função vinculada ao serviço AliyunServiceRoleForCEN (serviço cen.aliyuncs.com). Conceda a permissão ram:CreateServiceLinkedRole ao usuário antes de tentar novamente.
400	MissingParam.CenIdOrRegionId	Either CenId or RegionId must be specified.	É necessário definir CenId ou RegionId.
400	IllegalParam.ZoneId	The specified ZoneId is illegal.	O ZoneId informado é inválido.
400	IllegalParam.ChargeType	The specified ChargeType is illegal.	O método de faturamento especificado não é válido.
400	InvalidTransitRouterId.NotFound	The specified TransitRouterId is not found.	O transit router indicado não existe.
400	IncorrectStatus.Attachment	The resource is not in a valid state for the attachment operation.	Operação não permitida enquanto a instância de rede está sendo processada. Tente mais tarde.
400	IncorrectStatus.Vpc	The resource is not in a valid state for the attachment operation.	A instância de rede está em processamento, impedindo a execução desta operação. Aguarde e tente novamente.
400	Forbbiden.TransitRouterServiceNotOpen	The user has not open transit router service.	O recurso de transit router não está ativado. Ative-o e repita a operação.
400	OperationUnsupported.TransitRouterType	The specified TransitRouterType does not support the operation.	Este tipo de transit router não suporta a operação solicitada.
400	InvalidCenId.NotFound	CenId is not found.	A instância CEN especificada não foi encontrada.
400	IllegalParam.VSwitchId	VSwitchId is illegal.	O valor fornecido para VSwitchId é inválido.
400	IncorrectStatus.TransitRouterInstance	The status of TransitRouter is incorrect.	O transit router encontra-se em um estado inválido.
400	OperationUnsupported.CenFullLevel	CEN full level does not support TransitRouter	Instâncias CEN do tipo Full não são compatíveis com transit routers da Enterprise Edition.

Para obter uma lista completa de códigos de erro, consulte Códigos de erro do serviço.