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

Chama a operação CreateTransitRouterVpcAttachment para anexar uma instância de Virtual Private Cloud (VPC) a uma instância de transit router da Enterprise Edition para habilitar o peering de rede privada. Após a criação do anexo, a instância do transit router ajuda a implementar a conectividade de rede privada por meio de encaminhamento e roteamento.

Descrição da operação

Você pode criar um anexo de VPC para um transit router da Enterprise Edition de duas maneiras:
- Se você já criou uma instância de transit router da Enterprise Edition na região de destino, especifique VpcId, ZoneMappings.N.VSwitchId, ZoneMappings.N.ZoneId, TransitRouterId e RegionId para criar o anexo de VPC.
- Se você não criou uma instância de transit router da Enterprise Edition na região de destino, especifique VpcId, ZoneMappings.N.VSwitchId, ZoneMappings.N.ZoneId, CenId e RegionId para criar o anexo de VPC. O sistema usa a criação automática para criar uma instância de transit router da Enterprise Edition quando você cria o anexo de VPC.
CreateTransitRouterVpcAttachment é uma operação assíncrona. O sistema retorna um ID de anexo de VPC antes que o anexo de VPC seja criado. A tarefa de criação é executada em segundo plano. Chame ListTransitRouterVpcAttachments para consultar o status do anexo de VPC.
- Quando o anexo de VPC está no estado Attaching, o anexo de VPC está sendo criado. Nesse estado, você pode apenas consultar o anexo de VPC e não pode executar outras operações.
- Quando o anexo de VPC está no estado Attached, o anexo de VPC foi criado.
Após a criação de um anexo de VPC, ele não se associa a nenhuma tabela de rotas do transit router para relações de aprendizado de rotas ou relações de encaminhamento por padrão.

Antes de começar

Antes de chamar esta operação para criar um anexo de VPC, certifique-se de que os seguintes requisitos sejam atendidos:

A instância de VPC possui pelo menos uma instância de vSwitch com pelo menos um endereço IP disponível em uma zona suportada pelo transit router da Enterprise Edition. Para obter informações sobre as regiões e zonas suportadas pelos transit routers da Enterprise Edition, consulte Regiões e zonas suportadas por transit routers da Enterprise Edition.
Se você deseja anexar uma instância conectada a VPC que pertence a uma conta diferente, obtenha primeiro a autorização entre contas. Para obter mais informações, consulte Autorização de instância conectada a VPC entre contas.
A criação de um anexo de VPC incorre em taxas. Certifique-se de compreender as regras de cobrança. Para obter mais informações, consulte Cobrança.

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

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. Gere um valor exclusivo no seu cliente para este parâmetro. O ClientToken aceita apenas caracteres ASCII. Nota Se você não especificar este parâmetro, o sistema usará o RequestId da solicitação de API como ClientToken. O RequestId de cada solicitação de API é diferente.	02fb3da4-130e-11e9-8e44-001****
CenId	string	Não	O ID da instância da Cloud Enterprise Network (CEN).	cen-j3jzhw1zpau2km****
TransitRouterId	string	Não	O ID da instância do transit router da Enterprise Edition.	tr-bp1su1ytdxtataupl****
RegionId	string	Não	O ID da região onde a instância de VPC está implantada. Você pode chamar DescribeChildInstanceRegions para consultar os IDs de região.	cn-hangzhou
TransitRouterAttachmentName	string	Não	O nome do anexo de VPC. O nome pode ser deixado em branco ou pode conter de 1 a 128 caracteres. Não pode começar com http:// ou https://.	nomedetest
TransitRouterAttachmentDescription	string	Não	A descrição do anexo de VPC. A descrição pode ser deixada em branco ou pode conter de 1 a 256 caracteres. Não pode começar com http:// ou https://.	nomedetest
VpcId	string	Sim	O ID da instância da VPC.	vpc-bp1kbjcre9vtsebo1****
VpcOwnerId	integer	Não	O ID da conta do Alibaba Cloud à qual a instância de VPC pertence. O valor padrão é o ID da conta do Alibaba Cloud atualmente conectada. Nota Este parâmetro é obrigatório se você deseja anexar uma instância de rede que pertence a uma conta diferente.	1250123456123456
ChargeType	string	Não	O método de cobrança. Valor padrão: POSTPAY, que indica o método de cobrança pay-as-you-go.	POSTPAY
DryRun	boolean	Não	Especifica se deve ser realizado um dry run na solicitação, incluindo verificações de permissão e validação de status da instância. Valores válidos: false (padrão): envia uma solicitação normal e cria uma VPC após a aprovação na verificação. Use este valor para criar uma VPC. true: envia uma solicitação de dry run apenas para validação, sem criar o anexo de VPC. A verificação inclui se os parâmetros obrigatórios foram especificados e se o formato da solicitação é válido. Se a verificação falhar, o erro correspondente será retornado. Se a verificação for aprovada, o código de erro DryRunOperation será retornado.	false
ZoneMappings	array<object>	Sim	Selecione uma instância de vSwitch em uma zona suportada pelo transit router da Enterprise Edition. Você pode adicionar até 10 entradas por vez.
	object	Não	As informações sobre as zonas suportadas pelo transit router da Enterprise Edition e as instâncias de vSwitch correspondentes.
VSwitchId	string	Sim	A instância de vSwitch em uma zona suportada pelo transit router da Enterprise Edition. Você pode selecionar instâncias de vSwitch para até 10 zonas por vez.	vsw-bp1a214sbus8z3b54****
ZoneId	string	Sim	O ID de uma zona suportada pelo transit router da Enterprise Edition. Você pode chamar DescribeZones para consultar os IDs de zona. Você pode selecionar até 10 zonas por vez.	cn-hangzhou-h
AutoPublishRouteEnabled	boolean	Não	Especifica se o transit router da Enterprise Edition publica automaticamente entradas de rota na instância de VPC. false (padrão): não publica automaticamente entradas de rota. true: publica automaticamente entradas de rota.	true
TransitRouterVPCAttachmentOptions	object	Não	A lista de atributos de recurso para o anexo de VPC (a ser descontinuado — use o novo parâmetro Options).
	string	Não	O atributo de recurso para o anexo de VPC (a ser descontinuado — use o novo parâmetro Options). ipv6Support: especifica se o IPv6 deve ser ativado. enable: ativa o IPv6. disable: desativa o IPv6. Desativa o IPv6 para o anexo. Nota Antes de ativar o IPv6 para um anexo de VPC, certifique-se de que a instância de VPC e suas instâncias de vSwitch associadas tenham o IPv6 ativado. Para obter mais informações, consulte AllocateVpcIpv6Cidr e CreateVSwitchCidrReservation.	disable
Tag	array<object>	Não	A lista de tags. Você pode especificar até 20 tags por vez.
	object	Não	A tag.
Key	string	Não	A chave da tag do recurso. Se este parâmetro for especificado, não poderá ser uma string vazia. A chave da tag pode ter até 64 caracteres e não pode começar com aliyun ou acs:. Não pode conter http:// ou https://. Você pode especificar até 20 chaves de tag por vez.	tagteste
Value	string	Não	O valor da tag do recurso. Se este parâmetro for especificado, não poderá estar vazio. O valor da tag pode ter até 128 caracteres e não pode começar com aliyun ou acs:. Não pode conter http:// ou https://. Cada chave de tag corresponde a um valor de tag. Você pode especificar até 20 pares de chave-valor de tag por vez.	tagteste
Options	object	Não	A coleção de atributos de recurso.
ApplianceModeSupport	string	Não	Especifica se o modo de redirecionamento de tráfego do appliance de rede deve ser ativado. disable (padrão): desativado. enable: ativado.	enable
Ipv6Support	string	Não	Especifica se o suporte a IPv6 deve ser ativado. disable (padrão): desativado. enable: ativado.	enable

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	O resultado da resposta.
RequestId	string	O ID da solicitação.	C087A369-82B9-43EF-91F4-4B63A9C6E6B6
TransitRouterAttachmentId	string	O ID do anexo de VPC.	tr-attach-ia340z7xis7t5s****

Exemplos

Resposta de sucesso

JSON formato

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

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	OperationUnsupported.TransitRouterRegionId	The specified TransitRouterRegion does not support the operation.
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.	Você não tem permissão para criar a função vinculada ao serviço. Nome da função: AliyunServiceRoleForCEN. Nome do serviço: cen.aliyuncs.com. Certifique-se de que a permissão ram:CreateServiceLinkedRole foi concedida ao usuário atual.
400	IllegalParam.RegionId	The Specified Parameter RegionId is illegal	A região especificada na solicitação é inválida.
400	MissingParam.CenIdOrRegionId	Either CenId or RegionId must be specified.	CenId ou RegionId é um parâmetro obrigatório.
400	IllegalParam.ZoneId	The specified ZoneId is illegal.	A zona especificada é inválida.
400	IllegalParam.ChargeType	The specified ChargeType is illegal.	O tipo de cobrança é inválido.
400	InvalidTransitRouterId.NotFound	The specified TransitRouterId is not found.	O transit router correspondente não foi encontrado.
400	IncorrectStatus.VpcResource	The resource is not in a valid state for the attachment operation.	O recurso VPC não está em um estado estável e não pode ser operado. Aguarde até que as operações relacionadas na VPC atual sejam concluídas e tente novamente.
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	IncorrectStatus.VpcOrVswitch	The Vpc Or Vswith is not in a valid state for the attachment operation.	O estado atual da VPC ou do vSwitch não suporta esta operação. Tente novamente mais tarde.
400	OperationNotSupport.VpcAutoRoutesPublish	Auto publish vpc routes is not supported in this region.	O anúncio automático de rotas de VPC não é suportado na região atual.
400	InvalidOperation.VpnAssociated	The operation is not supported because the VPC is associated with VPN.	A VPC atual está anexada a uma VPN. O recurso de sincronização automática de roteamento não pode ser ativado.
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	IllegalParam.ZoneMappings	The Specified Parameter ZoneMappings is illegal	O ZoneMappings especificado no parâmetro é inválido.
400	OperationUnsupported.TransitRouterType	The specified TransitRouterType does not support the operation.	O tipo atual de transit router não suporta esta operação.
400	InvalidCenId.NotFound	CenId is not found.	A instância CEN não existe.
400	IllegalParam.VSwitchId	VSwitchId is illegal.	O VSwitchId especificado no parâmetro é inválido.
400	IncorrectStatus.TransitRouterInstance	The status of TransitRouter is incorrect.	O transit router está em um estado inválido.
400	OperationUnsupported.CenFullLevel	CEN full level does not support TransitRouter	Uma instância CEN do tipo Full não oferece suporte à criação de transit routers Enterprise Edition.
400	IllegalParam.ServiceMode	ServiceMode is illegal.	O ServiceMode é inválido.
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	OperationUnsupported.CloudBoxVswNotSupport	Cloud Box vsw does not support.	O vSwitch de um CloudBox não pode ser carregado.
400	IncorrectStatus.TransitRouter	The status of TransitRouter is incorrect.	O status atual do roteador de trânsito não suporta esta operação. Tente novamente mais tarde.
400	Duplicated.ZoneMapping	The parameter ZoneMapping is duplicated.	ZoneMapping contém entradas duplicadas.
400	QuotaExceeded.CenQuotaVpcAttachPerTransitRouter	The maximum number of VPC attachment per Transit Router is exceeded.	O número de virtual private clouds (VPCs) que podem ser conectados a cada transit router excedeu o limite.
400	IncorrectStatus.VpcRouteTable	The VPC route table is not in a desired state.	A tabela de rotas da VPC associada a esta operação não está em um estado estável e não pode ser operada. Tente novamente mais tarde.
400	InvalidStatus.VpcAttachedFullModeCen	The VPC has been attached to another CEN instance whose protection level is FULL.	A VPC especificada na solicitação já está anexada a outra instância CEN com o nível de proteção definido como FULL e não pode ser anexada a outras instâncias CEN.
400	Forbbiden.AttachChildInstanceAcrossBid	VPCs that belong to another BID cannot be associated. You need to apply for cross-BID attaching.	Não é permitido associar uma VPC sob uma conta bid diferente.
400	InvalidOperation.VpcAutoRoutesPublishInOtherCEN	The specified VPC already has its routes synchronized with another CEN instance.	A VPC atual já ativou a sincronização automática de roteamento em outra instância CEN. Esta operação não é suportada.
400	QuotaExceeded.VpcAutoRoutesPublishPerTransitRouter	The number of VPCs that have route synchronization enabled has reached the upper limit.	O número de VPCs com sincronização automática de roteamento ativada atingiu o limite superior.
400	InsufficientIpAddr.vsw	Insufficient available IP addresses in the vSwitch.	O número de endereços IP ativos no vSwitch é insuficiente.
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	IllegalParam.TransitRouterRegionId	TransitRouterRegionId is illegal.	O TransitRouterRegionId é inválido.
400	InvalidTransitRouterMode.NeedUpgrade	TransitRouter need to upgrade.	O modo atual do transit router não é suportado.
400	IllegalParam.Ipv6Support	Ipv6Support is illegal. Valid Values are [enable, disable].	O valor do parâmetro de solicitação Ipv6Support é inválido. Valores válidos: enable e disable.
400	OperationFailed.VSwitchNotFound	The specified vswitch not found.	O VSwitchId especificado não existe. Verifique se o vSwitch está disponível ou especifique outro vSwitch disponível.
400	OperationFailed.VSwitchIpv6CidrNotAllocated	The specified vswitch does not have IPv6 address allocated.	O vSwitch especificado não tem o IPv6 ativado. Ative o IPv6 antes de realizar esta operação.
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	ParamExclusive.TransitRouterVPCAttachmentOptionsAndOptions	When creating or modifying a VPC attachment, the input parameter TransitRouterVPCAttachmentOptions and Options cannot be used at the same time.	Ao criar ou modificar uma conectividade de rede VPC, os parâmetros TransitRouterVPCAttachmentOptions e Options não podem ser usados ao mesmo tempo.
400	InvalidParameter.ApplianceModeSupport	The specified parameter ApplianceModeSupport is invalid.	O parâmetro ApplianceModeSupport é inválido.
400	InvalidParameter.Ipv6Support	The specified parameter Ipv6Support is invalid.	O parâmetro Ipv6Support especificado é inválido.
400	INVALID_OPERATION_RESOURCE_NOT_SUPPORT_APPLIANCE_MODE	Only VPC attachment support appliance mode.	Apenas a conectividade de rede VPC oferece suporte ao padrão de redirecionamento de tráfego de elementos de rede.
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.
400	OperationFailed.PostPay95BwpNotAllowEnterpriseTr	Cbn with post pay 95 bandwidth package does not allow enterprise tr.	Uma instância CEN que utiliza um plano de largura de banda no 95º percentil legado não suporta a criação de um transit router Enterprise Edition.
400	OperationUnsupported.VpcRoutePropagationSource	The operation on this VPC route propagation source is not supported.	Não há suporte para operações nesta origem de propagação de rotas da VPC.
404	InvalidVSwitchId.NotFound	The specified VSwitchId is not found.	O VSwitchId especificado não existe.
409	InvalidOperation.CenInstanceStatus	The CEN instance is not in a valid state for the operation.	O status atual do CEN não suporta esta operação. Tente novamente mais tarde.
409	IncorrectStatus.VpcSwitch	The resource is not in a valid state for the attachment operation.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.