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

Cria uma instância de transit router da Enterprise Edition.

Descrição da operação

Você pode invocar a operação CreateTransitRouter para criar uma instância de transit router da Enterprise Edition para encaminhar tráfego e executar roteamento. Os transit routers da Enterprise Edition estão disponíveis apenas em regiões específicas. Para obter mais informações sobre as regiões suportadas, consulte O que é o Cloud Enterprise Network?.
A operação CreateTransitRouter é assíncrona. Após invocar esta operação, o sistema retorna o ID da instância do transit router da Enterprise Edition. No entanto, a instância não é criada imediatamente, e o nó de criação ainda está sendo executado em segundo plano. Você pode invocar a operação ListTransitRouters para consultar o status da instância do transit router da Enterprise Edition.
- Se a instância do transit router da Enterprise Edition estiver no estado Creating, a instância está sendo criada. Neste estado, você pode executar apenas operações de consulta na instância e não pode realizar outras operações.
- Se a instância do transit router da Enterprise Edition estiver no estado Active, a instância foi criada.
Você pode criar apenas uma instância de transit router em cada região para uma instância do Cloud Enterprise Network (CEN).

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

create

CenInstance.

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

TransitRouter.

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

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 gerar o valor do parâmetro em seu cliente. Certifique-se de que o token 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 é diferente.	02fb3da4-130e-11e9-8e44-001****
CenId	string	Sim	O ID da instância do Cloud Enterprise Network (CEN).	cen-j3jzhw1zpau2km****
RegionId	string	Sim	O ID da região da instância do transit router da Enterprise Edition. Você pode chamar a operação DescribeChildInstanceRegions para consultar os IDs de região.	cn-zhangjiakou
TransitRouterName	string	Não	O nome da instância do transit router da Enterprise Edition. O nome pode estar vazio ou ter de 1 a 128 caracteres e não pode começar com http:// ou https://.	testname
TransitRouterDescription	string	Não	A descrição da instância do transit router da Enterprise Edition. A descrição pode estar vazia ou ter de 1 a 256 caracteres e não pode começar com http:// ou https://.	testdesc
DryRun	boolean	Não	Especifica se deve ser realizado um dry run na solicitação de criação. O dry run inclui verificações de permissão e status da instância. Valores válidos: false (padrão): envia uma solicitação normal e cria a instância do transit router da Enterprise Edition após a solicitação passar na verificação. true: envia uma solicitação de dry run e realiza apenas a verificação sem criar a instância do transit router da Enterprise Edition. O sistema verifica se os parâmetros obrigatórios foram especificados e se o formato da solicitação é válido. Se a solicitação falhar na verificação, o sistema retornará um erro. Se a solicitação passar na verificação, o sistema retornará o código de erro `DryRunOperation`.	false
SupportMulticast	boolean	Não	Especifica se o recurso de multicast deve ser ativado para o transit router da Enterprise Edition. Valores válidos: false (padrão): desativa o recurso. true: ativa o recurso. O recurso de multicast é suportado apenas por transit routers da Enterprise Edition em regiões específicas. Você pode chamar a operação ListTransitRouterAvailableResource para consultar as regiões que suportam o recurso de multicast.	false
TransitRouterCidrList	array<object>	Não	Os blocos CIDR do transit router.
	object	Não	Os blocos CIDR do transit router. Você pode adicionar até 5 blocos CIDR do transit router por vez. Para obter mais informações sobre os blocos CIDR do transit router, consulte Blocos CIDR do transit router. Nota Apenas os transit routers da Enterprise Edition suportam a adição de blocos CIDR.
Cidr	string	Não	O bloco CIDR do transit router.	192.168.10.0/24
Name	string	Não	O nome do bloco CIDR do transit router. O nome deve ter de 1 a 128 caracteres.	nametest
Description	string	Não	A descrição do bloco CIDR do transit router. A descrição deve ter de 1 a 256 caracteres.	desctest
PublishCidrRoute	boolean	Não	Especifica se o sistema pode adicionar automaticamente uma rota para o bloco CIDR do transit router na tabela de rotas do transit router. Valores válidos: true (padrão): permite que o sistema adicione a rota automaticamente. Se você selecionar este valor, após criar uma conexão VPN do tipo gateway de rede privada e criar uma correlação de aprendizado de rota para a conexão VPN, o sistema adiciona automaticamente uma entrada de rota à tabela de rotas do transit router que possui uma correlação de aprendizado de rota com a conexão VPN: O bloco CIDR de destino da rota é uma rota blackhole para o bloco CIDR do transit router. O bloco CIDR do transit router refere-se ao bloco CIDR ao qual um endereço IP de gateway foi atribuído para a conexão IPsec. A rota blackhole é propagada apenas para a tabela de rotas da instância do Virtual Border Router (VBR) sob o transit router. false: não permite que o sistema adicione a rota automaticamente.	true
Tag	array<object>	Não	As informações da tag.
	object	Não	As informações da tag. Você pode especificar até 20 tags por vez.
Key	string	Não	A chave da tag do recurso. A chave da tag não pode ser uma string vazia. A chave da tag pode ter até 64 caracteres e não pode começar com `aliyun` ou `acs:`. A chave da tag não pode conter `http://` ou `https://`. Você pode especificar até 20 chaves de tag por vez.	tagtest
Value	string	Não	O valor da tag do recurso. O valor da tag não pode estar vazio. O valor da tag pode ter até 128 caracteres e não pode começar com `aliyun` ou `acs:`. O valor da tag não pode 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	O resultado da resposta.
TransitRouterId	string	O ID da instância do transit router da Enterprise Edition, que é usado para encaminhar tráfego e executar roteamento. Após a criação da instância, ela fica no estado Creating. Você deve aguardar até que a instância entre no estado Active antes de prosseguir para os próximos passos. Você pode invocar a operação ListTransitRouters para consultar o status da instância.	tr-uf6llz2286805i44g****
RequestId	string	O ID da solicitação.	404DA7EC-F495-44B5-B543-6EDCDF90F3D1

Exemplos

Resposta de sucesso

JSON formato

{
  "TransitRouterId": "tr-uf6llz2286805i44g****",
  "RequestId": "404DA7EC-F495-44B5-B543-6EDCDF90F3D1"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	OperationUnsupported.RegionId	The specified Region is not supported.	Não há suporte para esta operação na região especificada.
400	InstanceExist.TransitRouterInstance	The instance already exists.	Uma instância de transit router já existe na região atual. Você não pode criar instâncias de transit router duplicadas na mesma região.
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.SupportMulticast	The multicast is not supported in the specified region.	Não há suporte para multicast na região atual.
400	OperationUnsupported.CenFullLevel	CEN full level does not support TransitRouter.
400	IllegalParam.Cidr	Cidr is illegal.	O bloco CIDR especificado na solicitação é inválido.
400	Illegal.TrType	The TransitRouter type is illegal.	O tipo de roteador de trânsito não suporta esta operação.
400	OperationUnsupported.TransitRouterCidrList	The TransitRouterCidrList is not support in the specified Region.	A região atual não suporta esta operação.
400	OperationFailed.CidrConflict	Operation is invalid because the cidr conflict.	O bloco CIDR entra em conflito com um bloco existente.
400	IllegalParam.Region	The specified region is invalid.
400	OverLappingExist.Cidr	The cidr overlapping exist.	A sobreposição de blocos CIDR já existe.
400	IllegalParam.ServiceMode	The specified ServiceMode is invalid.	O ServiceMode é inválido.
400	ParamExclusive.ServiceModeAndSupportMulticast	ServiceMode and SupportMulticast is mutually exclusive.	Os roteadores de trânsito neste modo não suportam a ativação do recurso de multicast.
400	ParamExclusive.ServiceModeAndTransitRouterCidrList	ServiceMode and TransitRouterCidrList is mutually exclusive.	Os roteadores de trânsito neste modo não suportam a ativação do recurso CIDR.
400	OperationUnsupported.Tag	The Tag is not supported in the specified region.	Não há suporte para o recurso de tag do roteador de trânsito nesta região.
400	IllegalParam.SupportMulticast	Basic Transit router is not support multicast.	Os roteadores de trânsito da Basic Edition não suportam o recurso de multicast.
400	ParamExclusive.BasicAndPrimaryStandby	Basic and PrimaryStandby is mutually exclusive.	Os roteadores de trânsito da Edição Básica não suportam a definição do modo como PrimaryStandby.
400	ParamExclusive.BasicAndMultiPrimary	Basic and MultiPrimary is mutually exclusive.	Os roteadores de trânsito da Edição Básica não suportam a definição do modo como MultiPrimary.
400	IllegalParam.RegionId	The Specified Parameter RegionId is illegal.	O parâmetro Region especificado é inválido.
400	OperationFailed.PostPay95BwpNotAllowEnterpriseTr	Cbn with post pay 95 bandwidth package does not allow enterprise tr.	Uma instância do Cloud Enterprise Network (CEN) que usa um plano de largura de banda de percentil 95 legado não permite a criação de um transit router Enterprise Edition.
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	IllegalParam.TagValue	The tag values are not valid.	O valor da tag especificado na solicitação é inválido.
400	IllegalParam.TagKey	The tag keys are not valid.	A chave da tag especificada na solicitação é inválida.
400	InvalidParameter.TagValue	The specified parameter TagValue is invalid.	O parâmetro Tag Value especificado é inválido.
400	ParamExclusive.ServiceModeAndSupportJumboFrame	Parameter ServiceMode And SupportJumboFrame are mutually exclusive.	Os roteadores de trânsito no modo primário/em espera não suportam o recurso de jumbo frame.
400	OperationUnsupported.SupportJumboFrame	JumboFrame is unsupported.	Não há suporte para o recurso de jumbo frame.
400	ParamExclusive.SupportJumboFrameAndSupportMulticast	Transit Router can not support JumboFrame and Multicast at the same time.	Os roteadores de trânsito não suportam a ativação dos recursos de jumbo frame e multicast ao mesmo tempo.
400	IllegalParam.SupportJumboFrame	The error message returned because Basic Edition transit routers do not support JumboFrame.	Os roteadores de trânsito da Basic Edition não suportam o recurso de multicast.
400	InvalidParameter.CenId	The specified parameter CenId is invalid.	O parâmetro CenId especificado é inválido.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.