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

Observações de uso

Chame a operação CreateTransitRouter para criar um transit router da Enterprise Edition. Para obter mais informações sobre as regiões compatíveis com transit routers da Enterprise Edition, consulte O que é o CEN?.
A operação CreateTransitRouter é assíncrona. Após o envio da solicitação, o sistema retorna o ID do transit router, mas a execução continua em segundo plano. Chame a operação ListTransitRouters para consultar o status de um transit router da Enterprise Edition.
- Se o transit router da Enterprise Edition estiver no estado Creating, ele ainda está sendo criado. Nesse cenário, é possível consultar o transit router, mas não é permitido executar outras operações.
- Quando o transit router da Enterprise Edition atinge o estado Active, a criação foi concluída com sucesso.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	CreateTransitRouter	A operação a ser executada. Defina o valor como CreateTransitRouter.
ClientToken	String	Não	02fb3da4-130e-11e9-8e44-001****	Token de cliente usado para garantir a idempotência da solicitação. Use o cliente para gerar esse valor e garanta que seja único entre todas as solicitações. O token aceita apenas caracteres ASCII. Nota Se você não definir este parâmetro, o sistema usará automaticamente o RequestId como ClientToken. O valor do RequestId pode variar a cada solicitação de API.
CenId	String	Sim	cen-j3jzhw1zpau2km****	ID da instância do Cloud Enterprise Network (CEN).
RegionId	String	Sim	cn-zhangjiakou	ID da região onde o transit router da Enterprise Edition será implantado. Chame a operação DescribeChildInstanceRegions para obter a lista mais recente de regiões.
TransitRouterName	String	Não	testname	Nome do transit router da Enterprise Edition. O nome deve ter de 2 a 128 caracteres e pode conter letras, dígitos, pontos (.), sublinhados (_) e hifens (-). Deve começar com uma letra, mas não pode iniciar com `http://` ou `https://`.
TransitRouterDescription	String	Não	testdesc	Descrição do transit router da Enterprise Edition. A descrição deve ter de 2 a 256 caracteres. Precisa começar com uma letra e não pode iniciar com `http://` ou `https://`.
DryRun	Boolean	Não	false	Defina se a solicitação deve ser verificada sem executar a operação real. A verificação inclui permissões e o status dos recursos de nuvem especificados. Valores válidos: false (padrão): envia a solicitação. Se a verificação for aprovada, o transit router da Enterprise Edition será criado. true: verifica a solicitação sem criar o transit router da Enterprise Edition. Ao usar este valor, o sistema valida se os parâmetros obrigatórios foram definidos e se a sintaxe da solicitação é válida. Em caso de falha na verificação, o sistema retorna uma mensagem de erro. Se a verificação for bem-sucedida, o sistema retorna o código de erro `DryRunOperation`.
SupportMulticast	Boolean	Não	false	Indica se o recurso de multicast deve ser ativado no transit router da Enterprise Edition. Valores válidos: false (padrão): não true: sim O recurso de multicast está disponível apenas em regiões específicas. Chame a operação ListTransitRouterAvailableResource para consultar as regiões compatíveis com multicast.
TransitRouterCidrList	Array	Não		Blocos CIDR do transit router. É possível adicionar até cinco blocos CIDR por vez. Para mais detalhes sobre blocos CIDR de transit routers, consulte Blocos CIDR de transit routers. Nota Somente transit routers da Enterprise Edition oferecem suporte a blocos CIDR.
Cidr	String	Não	192.168.10.0/24	Bloco CIDR do transit router.
Name	String	Não	nametest	Nome do bloco CIDR. O nome deve ter de 1 a 128 caracteres.
Description	String	Não	desctest	Descrição do bloco CIDR. A descrição deve ter de 1 a 256 caracteres.
PublishCidrRoute	Boolean	Não	true	Defina se o sistema deve adicionar automaticamente uma rota apontando para o bloco CIDR na tabela de rotas do transit router. true (padrão): sim. O valor true indica que, após a criação de uma conexão VPN privada e a ativação do aprendizado de rotas para essa conexão, o sistema adiciona automaticamente uma rota blackhole à tabela de rotas do transit router ao qual a VPN está anexada. O bloco CIDR de destino da rota blackhole corresponde ao bloco CIDR do transit router. Esse bloco refere-se ao intervalo de endereços IP de onde os endereços IP do gateway são alocados para conexões IPsec-VPN. A rota blackhole é anunciada exclusivamente para a tabela de rotas do roteador de borda virtual (VBR) conectado ao transit router. false: não.
Tag.N.Key	String	Não	tagtest	Chave da tag. A chave da tag não pode ser uma string vazia. Pode ter até 64 caracteres e não deve começar com `acs:` ou `aliyun`. Também não pode conter `http://` ou `https://`. É permitido especificar no máximo 20 chaves de tag.
Tag.N.Value	String	Não	TagValue	Valor da tag. O valor da tag pode ter de 0 a 128 caracteres e não pode começar com `aliyun` ou `acs:`. Não deve conter `http://` ou `https://`. Cada chave de tag possui um valor exclusivo. Especifique até 20 valores de tag em cada chamada.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
TransitRouterId	String	tr-uf6llz2286805i44g****	ID do transit router da Enterprise Edition.
RequestId	String	404DA7EC-F495-44B5-B543-6EDCDF90F3D1	ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=CreateTransitRouter
&ClientToken=02fb3da4-130e-11e9-8e44-001****
&CenId=cen-j3jzhw1zpau2km****
&RegionId=cn-zhangjiakou
&TransitRouterName=testname
&TransitRouterDescription=testdesc
&DryRun=false
&SupportMulticast=false
&TransitRouterCidrList=[{"Cidr":"192.168.10.0/24","Name":"nametest","Description":"desctest","PublishCidrRoute":true}]
&Tag=[{"Key":"tagtest","Value":"TagValue"}]
&Common request parameters

Exemplos de respostas de sucesso

Formato XML

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

<CreateTransitRouterResponse>
    <TransitRouterId>tr-uf6llz2286805i44g****</TransitRouterId>
    <RequestId>404DA7EC-F495-44B5-B543-6EDCDF90F3D1</RequestId>
</CreateTransitRouterResponse>

Formato JSON

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

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

Códigos de erro

HttpCode	Códigos de erro	Mensagem de erro	Descrição
400	InstanceExist.TransitRouterInstance	The instance already exists.	Mensagem de erro retornada porque já existe um transit router com o mesmo ID na região atual. Os IDs de transit router devem ser exclusivos dentro da mesma região.
400	Forbbiden.TransitRouterServiceNotOpen	The user has not open transit router service.	Mensagem de erro retornada porque o serviço de transit router não está ativado. Ative o serviço e tente novamente.
400	IllegalParam.Region	The specified region is invalid.	Mensagem de erro retornada porque a região especificada é inválida.

Para obter uma lista de códigos de erro, visite a Central de Erros da API.