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

Adiciona uma entrada de rota a uma tabela de rotas de um roteador de trânsito Enterprise Edition.

Descrição da operação

CreateTransitRouterRouteEntry é uma operação assíncrona. Após o envio da solicitação, o sistema retorna um ID de entrada de rota, mas a entrada de rota ainda não foi criada. A tarefa de criação continua sendo executada em segundo plano. Você pode chamar ListTransitRouterRouteEntries para consultar o status da entrada de rota.

Se a entrada de rota estiver no estado Creating, a entrada de rota está sendo criada. Nesse estado, você só pode consultar a entrada de rota. Não é possível realizar outras operações na entrada de rota.
Se a entrada de rota estiver no estado Active, a entrada de rota foi criada.

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

create

*TransitRouterRouteTable

acs:cen:*:{#accountId}:centransitrouterroutetable/{#centransitrouterroutetableId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ClientToken	string	Não	O token do cliente usado para garantir a idempotência da solicitação. Você pode usar o cliente para gerar o token, mas deve garantir que o token seja exclusivo entre diferentes solicitações. O token do 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 pode ser diferente para cada solicitação de API.	02fb3da4-130e-11e9-8e44-001****
TransitRouterRouteEntryName	string	Não	O nome da entrada de rota. O nome pode estar vazio ou ter de 1 a 128 caracteres e não pode começar com http:// ou https://.	testname
TransitRouterRouteEntryDescription	string	Não	A descrição da entrada de rota. A descrição pode estar vazia ou ter de 1 a 256 caracteres e não pode começar com http:// ou https://.	testdesc
TransitRouterRouteTableId	string	Sim	O ID da tabela de rotas do roteador de trânsito Enterprise Edition.	vtb-bp1dudbh2d5na6b50****
TransitRouterRouteEntryNextHopType	string	Sim	O tipo de próximo salto. Valores válidos: BlackHole: especifica a entrada de rota como uma rota blackhole. Todos os pacotes destinados ao bloco CIDR de destino são descartados. Não é necessário especificar informações de próximo salto. Attachment: especifica o próximo salto da entrada de rota como uma conexão de instância de rede. Você também deve especificar o ID da conexão da instância de rede. Todos os pacotes destinados ao bloco CIDR de destino são encaminhados para a conexão da instância de rede especificada.	BlackHole
TransitRouterRouteEntryDestinationCidrBlock	string	Sim	O bloco CIDR de destino da entrada de rota. Endereços IPv4 e IPv6 são suportados.	192.168.0.0/24
TransitRouterRouteEntryNextHopId	string	Não	O ID da conexão da instância de rede associada ao próximo salto da entrada de rota.	tr-attach-nls9fzkfat8934****
DryRun	boolean	Não	Especifica se deve ser realizado um dry run, incluindo verificação de permissões e status da instância. Valores válidos: false (padrão): Envia uma solicitação normal e cria a entrada de rota após a solicitação passar pela verificação. true: Envia uma solicitação de verificação. Apenas a verificação é realizada. Nenhuma entrada de rota é criada. O sistema verifica 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 bem-sucedida, o código de erro `DryRunOperation` será retornado.	false

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
TransitRouterRouteEntryId	string	O ID da entrada de rota.	rte-75eg4jprkvk0pw****
RequestId	string	O ID da solicitação.	835E7F4B-B380-4E0F-96A5-6EA572388047

Exemplos

Resposta de sucesso

JSON formato

{
  "TransitRouterRouteEntryId": "rte-75eg4jprkvk0pw****",
  "RequestId": "835E7F4B-B380-4E0F-96A5-6EA572388047"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	DryRunOperation	Request validation has been passed with DryRun flag set.	A validação da solicitação DryRun foi aprovada.
400	InvalidTransitRouterRouteTableId.NotFound	TransitRouterRouteTableId is not found.	O ID da instância da tabela de rotas do roteador de trânsito não foi encontrado.
400	TransitRouterRouteEntryNextHopId.NotFound	TransitRouterRouteEntryNextHopId is not found.	O ID da instância de próximo salto da entrada de rota do roteador de trânsito não existe.
400	OperationFailed.CreateRouteEntryWithCCNAttachment	Operation failed because Create RouteEntry to CCN Attachment does not support.	A criação de rotas apontando para um anexo CCN não é suportada.
400	QuotaExceeded.TransitRouterRoutEntry	TransitRouterRoutEntry quota exceeded.	O número de rotas atingiu o limite superior.
400	IllegalParam.TransitRouterDestinationCidrBlock	TransitRouterDestinationCidrBlock is illegal.	O TransitRouterDestinationCidrBlock especificado na solicitação é inválido.
400	InstanceExist.TransitRouterRouteEntry	The instance TransitRouterRouteEntry already exists.	A entrada de rota do roteador de trânsito já existe.
400	IncorrectStatus.TransitRouterRouteTable	TransitRouterRouteTable status is invalid.	A tabela de rotas do roteador de trânsito está em um estado inválido.
400	ParamExclusive.RouteEntryIdAndRouteTableIdOrDestCidrBlock	RouteEntryId and TransitRouterRouteTableIdOrDestCidrBlock is mutually exclusive.	Os parâmetros RouteEntryId, TransitRouterRouteTableId e DestCidrBlock são mutuamente exclusivos.
400	InvalidDescription	Description is invalid.	A descrição é inválida.
400	InvalidName	Name is invalid.	O nome é inválido.
400	IllegalParam.NextHopType	The NextHopType is illegal.	O NextHopType especificado na solicitação é inválido.
400	MissingParam.TransitRouterRouteEntryNextHopId	The parameter TransitRouterRouteEntryNextHopId is mandatory	O parâmetro TransitRouterRouteEntryNextHopId está ausente.
400	InvalidTransitRouterRouteEntryNextHopId.NotFound	TransitRouterRouteEntryNextHopId is not found	O TransitRouterRouteEntryNextHopId não existe.
400	OperationFailed.CreateRouteEntryWithSameDestinationCidrBlock	Operation failed because Create RouteEntry with same destination cidrblock does not support.	Não é permitido criar entradas de rota com o mesmo bloco CIDR de destino.
400	InvalidDestinationCidrBlock.NotFound	DestinationCidrBlock is not found.	O DestinationCidrBlock especificado no parâmetro não existe.
400	OperationFailed.CreateRouteEntryWithConnectAttachment	Operation failed because Create RouteEntry to connect Attachment does not support.	A criação de rotas apontando para um anexo de conexão não é suportada.
400	ParamExclusive.NextHopTypeBlackHoleAndNextHopId	TransitRouterRouteEntryNextHopType(BlackHole) and TransitRouterRouteEntryNextHopId is mutually exclusive.	Quando a entrada de rota é uma rota blackhole, não especifique a conexão de próximo salto.
400	InvalidTransitRouterMode.NeedUpgrade	TransitRouter need to upgrade.	O modo atual do roteador de trânsito não é suportado.
400	OperationFailed.CreateTransitRouterRouteEntryWithVPCAttachment	The specified VPC Attachment has not enable IPv6.	O anexo VPC especificado não tem IPv6 ativado.
400	OperationFailed.CreateTransitRouterRouteEntryWithVPNAttachment	Create RouteEntry to VPN Attachment does not support IPv6.	A criação de entradas de rota IPv6 apontando para um anexo VPN não é suportada. Confirme a configuração antes de prosseguir.
400	NotSupport.AttachmentRoute	Not support such attachment route.	Esta rota de conexão não é suportada.
400	InvalidParameter	Invalid parameter.	O parâmetro é inválido.
400	Unauthorized	The AccessKeyId is unauthorized.	A conta não tem as permissões necessárias para realizar esta operação.
400	InvalidParameter.TransitRouterRouteEntryNextHopId	The specified parameter TransitRouterRouteEntryNextHopId is invalid.	O parâmetro TransitRouterRouteEntryNextHopId é inválido.
400	InvalidParameter.TransitRouterRouteTableId	The specified parameter TransitRouterRouteTableId is invalid.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.