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

Adiciona uma entrada de rota personalizada à tabela de rotas de um vRouter ou de um virtual border router (VBR).

Observações de uso

A operação CreateRouteEntry é assíncrona. Após o envio da solicitação, o sistema retorna um ID de solicitação e executa a tarefa em segundo plano. Para consultar o status da tarefa, chame a operação DescribeRouteEntryList.
- Se a entrada de rota estiver no estado Creating, ela está sendo adicionada.
- Se a entrada de rota estiver no estado Created, ela foi adicionada com sucesso.
Não chame a operação CreateRouteEntry repetidamente dentro de um curto período de tempo.

Ao executar esta operação, observe os seguintes limites:

Nota

Ao adicionar uma entrada de rota a partir de uma lista de prefixos, o uso da cota é calculado somando o número de entradas de rota existentes ao número máximo de entradas de rota da lista de prefixos.

Uma tabela de rotas pode conter até 200 entradas de rota personalizadas.
O bloco CIDR de destino (DestinationCidrBlock) de uma entrada de rota personalizada não pode ser idêntico ao bloco CIDR de um vSwitch na VPC. Ele pode abranger o bloco CIDR de um vSwitch, mas não pode estar contido nele.
O bloco CIDR de destino (DestinationCidrBlock) de uma entrada de rota personalizada não pode apontar para 100.64.0.0/10 nem estar contido nesse intervalo.
Os blocos CIDR de destino (DestinationCidrBlock) das entradas de rota na mesma tabela devem ser distintos entre si.
Caso o comprimento da máscara não seja incluído ao especificar o bloco CIDR de destino (DestinationCidrBlock), o sistema o tratará como um endereço IP de host com máscara de 32 bits.
Várias entradas de rota personalizadas podem apontar para o mesmo próximo salto (NextHopId).
O próximo salto (NextHopId) de uma entrada de rota personalizada e a tabela de rotas devem pertencer à mesma VPC.
Configure o roteamento de múltiplos caminhos de custo igual (ECMP) ao especificar o parâmetro NextHopList.
- Para adicionar uma entrada de rota personalizada comum (não ECMP), especifique DestinationCidrBlock, NextHopType e NextHopId. Não utilize o parâmetro NextHopList.
- Para adicionar uma entrada de rota ECMP, especifique DestinationCidrBlock e NextHopList. Não defina os parâmetros NextHopType e NextHopId neste cenário.

Ao utilizar esta operação para adicionar uma entrada de rota personalizada, atente-se às restrições abaixo:

O limite máximo é de 200 entradas de rota personalizadas por tabela de rotas.
O parâmetro NextHopList não é suportado.
O bloco CIDR de destino (DestinationCidrBlock) não pode apontar para 100.64.0.0/10 ou estar contido nesse intervalo.
Todos os blocos CIDR de destino (DestinationCidrBlock) dentro da mesma tabela de rotas precisam ser únicos.
Se o comprimento da máscara for omitido ao definir o bloco CIDR de destino (DestinationCidrBlock), ele será interpretado como um endereço IP de host com máscara de 32 bits.
Diversas entradas de rota personalizadas podem apontar para o mesmo próximo salto (NextHopId).
O próximo salto (NextHopId) de uma entrada de rota personalizada deve ser obrigatoriamente uma interface de roteador associada ao VBR.
O VBR precisa estar no estado Active e o circuito do Express Connect associado a ele deve estar no estado Enabled. Verifique também se não há pagamentos pendentes no circuito do Express Connect.
Somente entradas de rota comuns (não ECMP) são permitidas. Defina DestinationCidrBlock, NextHopType e NextHopId. O uso de NextHopList é proibido.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação diretamente no OpenAPI Explorer. A ferramenta gera dinamicamente exemplos de código da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	CreateRouteEntry	A operação que você deseja executar. Defina o valor como CreateRouteEntry.
RegionId	String	Não	cn-hangzhou	O ID da região da tabela de rotas. Chame a operação DescribeRegions para obter a lista mais recente de regiões.
RouteTableId	String	Sim	vtb-bp145q7glnuzd****	O ID da tabela de rotas onde você deseja adicionar a entrada de rota personalizada.
DestinationCidrBlock	String	Sim	192.168.0.0/24	O bloco CIDR de destino da entrada de rota personalizada. Blocos CIDR IPv4 e IPv6 são suportados. Certifique-se de que o bloco CIDR de destino atenda aos seguintes requisitos: O bloco CIDR de destino não é 100.64.0.0/10 nem um subconjunto de 100.64.0.0/10. O bloco CIDR de destino da entrada de rota personalizada difere dos blocos CIDR de destino de outras entradas na mesma tabela de rotas.
NextHopId	String	Não	i-j6c2fp57q8rr4jlu****	O ID do próximo salto da entrada de rota personalizada.
ClientToken	String	Não	02fb3da4-130e-11e9-8e44-001****	O token de cliente usado para garantir a idempotência da solicitação. Use o cliente para gerar o token, mas garanta que ele seja único entre solicitações diferentes. O token pode conter apenas caracteres ASCII. Nota Se este parâmetro não for especificado, o sistema usará automaticamente o ID da solicitação como o token de cliente. O ID da solicitação pode variar a cada nova requisição.
RouteEntryName	String	Não	test	O nome da entrada de rota personalizada que você deseja adicionar. O nome deve ter entre 1 e 128 caracteres. Não é permitido iniciar com `http://` ou `https://`.
Description	String	Não	test	A descrição da entrada de rota personalizada. A descrição deve ter entre 1 e 256 caracteres. Não pode começar com `http://` ou `https://`.
NextHopType	String	Não	RouterInterface	O tipo de próximo salto da entrada de rota personalizada. Valores válidos: Instance (padrão): instância do Elastic Compute Service (ECS) HaVip: endereço IP virtual de alta disponibilidade (HAVIP) RouterInterface: interface de roteador NetworkInterface: elastic network interface (ENI) VpnGateway: gateway VPN IPv6Gateway: gateway IPv6 NatGateway: gateway NAT Attachment: transit router VpcPeer: conexão de peering VPC
NextHopList.N.NextHopId	String	Não	ri-2zeo3xzyf3cd8r4****	O ID do próximo salto da entrada de rota ECMP.
NextHopList.N.Weight	Integer	Não	10	O peso do próximo salto da entrada de rota ECMP.
NextHopList.N.NextHopType	String	Não	RouterInterface	O tipo do próximo salto da entrada de rota ECMP. Defina o valor como RouterInterface.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RouteEntryId	String	rte-sn6vjkioxte1gz83z****	O ID da entrada de rota personalizada.
RequestId	String	0ED8D006-F706-4D23-88ED-E11ED28DCAC0	O ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=CreateRouteEntry
&RegionId=cn-hangzhou
&RouteTableId=vtb-bp145q7glnuzd****
&DestinationCidrBlock=192.168.0.0/24
&NextHopId=i-j6c2fp57q8rr4jlu****
&ClientToken=02fb3da4-130e-11e9-8e44-001****
&RouteEntryName=test
&Description=test
&NextHopType=RouterInterface
&NextHopList=[{"NextHopId":"ri-2zeo3xzyf3cd8r4****","Weight":10,"NextHopType":"RouterInterface"}]
&Common request parameters

Exemplos de respostas de sucesso

Formato XML

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

<CreateRouteEntryResponse>
    <RouteEntryId>rte-sn6vjkioxte1gz83z****</RouteEntryId>
    <RequestId>0ED8D006-F706-4D23-88ED-E11ED28DCAC0</RequestId>
</CreateRouteEntryResponse>

Formato JSON

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

{
  "RouteEntryId" : "rte-sn6vjkioxte1gz83z****",
  "RequestId" : "0ED8D006-F706-4D23-88ED-E11ED28DCAC0"
}

Códigos de erro

HttpCode	Código de erro	Mensagem de erro	Descrição
400	IllegalParam.CidrBlock	The specified CidrBlock is illegal.	O valor definido para CidrBlock é inválido.
400	QuotaExceeded	Route entry quota exceeded in this route table.	A quantidade de entradas de rota na tabela atingiu o limite máximo.
400	MissingParameter	Miss mandatory parameter.	Um ou mais parâmetros obrigatórios não foram definidos. Verifique se todos os parâmetros necessários foram configurados antes de chamar esta operação.
400	InvalidCidrBlock.Malformed	Specified CIDR block is not valid.	O formato do bloco CIDR especificado é inválido.
400	InvalidCIDRBlock.Duplicate	Specified CIDR block is already exists.	O bloco CIDR especificado já existe na tabela de rotas.
400	IncorrectVpcStatus	Current VPC status does not support this operation.	Esta operação não pode ser realizada quando a VPC está no estado atual.
400	IncorrectInstanceStatus	Current instance status does not support this operation.	Esta operação não pode ser executada enquanto a instância estiver no estado atual.
400	IncorrectRouteEntryStatus	Some route entry status blocked this operation.	Uma ou mais entradas de rota na tabela atual estão no estado Pending ou Modifying.
400	IncorrectVSwitchStatus	The current virtual switch status does not support this operation.	O vSwitch está no estado Pending e não pode ser excluído.
400	InvalidCidrBlock	Specified CIDR block is not valid.	Mensagem de erro retornada por um dos seguintes motivos: 1. Você não tem autorização para usar o bloco CIDR 10.0.0.0/8. Verifique se sua conta está incluída na lista de permissões para usar esse bloco CIDR. 2. O bloco CIDR de destino da entrada de rota personalizada adicionada não pode ser um subconjunto dos blocos CIDR dos vSwitches na VPC. 3. O bloco CIDR não pode ser 100.64.0.0/10.
400	InvalidNextHopType	Specified parameter "NextHopType" is not valid	O tipo de próximo salto especificado é inválido.
400	InvalidNextHop.NotFound	Specified next hop does not exist.	O próximo salto especificado não existe.
400	InvalidVRouter.NotFound	vRouter not exists.	O vRouter especificado não existe. Verifique se o vRouter informado é válido.
400	InvalidVPC.NotFound	vpc not exists.	A VPC especificada não existe. Verifique se a VPC informada é válida.
400	InvalidNexthopTypeAndList.BothNull	both nexthopType and nextHopList are null.	NextHopType e NextHopList não foram especificados.
400	InvalidNexthopTypeAndList.BothNotNull	both nexthopType and nextHopList are not null.	Você não pode deixar NextHopType e NextHopList vazios simultaneamente.
400	InvalidRouterInterface	invalid router interface.	A interface de roteador especificada não existe.
400	InvalidOppositeRouterType	nexthop list cannot only contain router interface whose opposite router interface is on vbr.	O próximo salto especificado é inválido. O roteador par da interface de roteador definida como próximo salto deve ser um VBR.
400	InvalidNexthopListSize	nexthop size is illegal. Must be between 2 and 4.	É necessário especificar de duas a quatro interfaces de roteador como próximos saltos.
400	InvalidEntryRuleQuota.NotFound	Route entry quota rule not exists.	As regras de cota de entradas de rota não existem.
400	Forbidden.CheckEntryRuleQuota	Route entry quota rule check error.	Ocorreu um erro durante a verificação da cota de entradas de rota pelo sistema.
400	InvalidVBRStatus	invalid virtual border router status.	O VBR está em um estado inválido.
400	InvalidPhysicalConnectionBusinessStatus	invalid physical connection business status.	O circuito do Express Connect está em um estado inválido.
400	IncorrectHaVipStatus	This operation is denied because satus of the specified HaVip is neither Available nor InUse.	A operação não pode ser executada quando o HAVIP especificado está no estado Available ou InUse.
400	CountLimitExceed.HaVipRouteEntry	There can be 5 route entry to HaVip at most in one route table.	O número de entradas de rota que apontam para o HAVIP atingiu o limite superior.
400	InvalidRouteEntry.Duplicate	The route entry already exist.	A entrada de rota especificada já existe.
400	IncorrectRouteEntryStatus	Specified routeEntry status error.	Uma ou mais entradas de rota na tabela atual estão no estado Pending ou Modifying.
400	IncorrectRouteEntryStatus	VBR has NotStable route entry.	Uma ou mais entradas de rota no VBR atual estão no estado Pending ou Modifying.
400	InvalidParam	The Ecmp routerEntry with router interfaces local vgw vip not match.	A entrada de rota não corresponde ao endereço IP do gateway da interface de roteador.
400	INVALID_WEIGHT_PARAM	Specified value of weight invalid	O peso especificado é inválido.
400	FORBIDDEN_USE_VPC_AS_INTERNET_GATEWAY	The Specified CIDR must be in vpc CIDR.	O bloco CIDR especificado deve ser um subconjunto do bloco CIDR da VPC.
400	INVALID_VPC_ID	The Specified VpcId not match.	A VPC não foi encontrada.
400	InvalidRouteEntrySize	The Specified routerEntry size not legal.	Para configurar roteamento ECMP, especifique de duas a quatro interfaces de roteador como próximos saltos.
400	TaskConflict	The operation is too frequent, please wait a moment and try again.	Suas solicitações são muito frequentes. Tente novamente mais tarde.
400	InvalidRouteEntry	Specified routeEntry not exist.	A entrada de rota especificada não existe.
400	RouteConflict.AlreadyExist	Route conflict exists in routing table.	Existem conflitos de rota na tabela de rotas.
400	InvalidRouteEntryName.Malformed	Specified RouteEntry name is not valid.	O nome da entrada de rota é inválido.
400	InvalidNexthop.DirectEni	The direct Eni cannot be nexthop.	Uma ENI em modo cut-through não pode ser especificada como próximo salto.
400	QuotaExceeded.VpnRouteEntry	Vpn route entry quota exceeded.	Falha ao criar a entrada de rota. Verifique se o número de entradas de rota na tabela de rotas do gateway VPN atingiu o limite superior.
400	InvalidAttachment.NotFound	The attachment is not found.	O transit router especificado não existe.
400	OperationFailed.ActiveNetworkInterfaceNotFound	No active network interface is found on the attachment.	Nenhuma ENI disponível foi encontrada no transit router especificado.
400	InvalidNetworkInterface.NotFound	The network interface is not found on the attachment.	Nenhuma ENI está associada ao transit router especificado.
400	OperationFailed.QueryAttachmentInfo	Failed to query attachment information.	O sistema falhou ao consultar o transit router.
400	IllegalParam.AttachmentId	The attachment is invalid.	O transit router especificado é inválido.
400	OperationFailed.NotSupportIPV6	The specified next hop does not support IPv6.	O próximo salto especificado não suporta IPv6.
400	IncorrectStatus.Ipv6Address	The IPv6 address of the specified next hop is being assigned or deleted.	Um endereço IPv6 está sendo atribuído ou removido do próximo salto.
400	OperationUnsupported.Ipv6EntryOnPrimaryNetworkInterface	You cannot create IPv6 route entries on a primary network interface.	Não é possível criar uma entrada de rota IPv6 cujo próximo salto seja uma ENI primária.
400	OperationUnsupported.SpecifyIpOnIpv6Entry	You cannot specify the private IP address when you create IPv6 route entries.	Não é possível especificar um endereço IPv6 privado como bloco CIDR de destino.
400	OperationUnsupported.MutipleIpv6Address	You cannot specify a next hop that has bound multiple IPv6 addresses.	Não é possível especificar um próximo salto que tenha múltiplos endereços IPv6 atribuídos.
400	OperationDenied.Ipv6EntryOnCustomTable	You cannot create any IPv6 route entry on a custom route table.	Não é permitido adicionar uma entrada de rota IPv6 a uma tabela de rotas personalizada.
400	OperationDenied.CloudBoxVbrEntryAllowedInCustomRouteTable	The operation is not allowed because only the custom routing table can add a routing entry with the next hop pointing to the cloud box type VBR.	Só é possível adicionar uma entrada de rota a uma tabela de rotas personalizada se o próximo salto apontar para um VBR conectado a uma CloudBox.
400	OperationDenied.RouteTableAssociateNotCloudBoxVSwitch	The operation is not allowed because of the routing table is bound to a non-cloud box type vswitch, and routing entries pointing to the cloud box VBR cannot be added.	O vSwitch associado à tabela de rotas não está conectado a uma instância CloudBox. Portanto, não é possível adicionar uma entrada de rota que aponte para um VBR conectado a uma CloudBox.
400	OperationDenied.VbrMisMatchCloudBox	The operation is not allowed because the routing table is bound to a cloud box vswitch, and routing entries pointing to other cloud box VBRs cannot be added.	O VBR e o vSwitch associado à tabela de rotas estão conectados a instâncias CloudBox diferentes.
400	OperationDenied.VbrIdle	The operation is not allowed because the next hop of the added routing entry is a VBR type RI at the opposite end, which cannot be in an idle state.	A interface de roteador especificada como próximo salto está no estado Idle. Se o roteador par da interface de roteador de próximo salto for um VBR, a interface de roteador de próximo salto não deve estar no estado Idle.
400	OperationDenied.RouterInterfaceToDifferentVpc	The operation is not allowed because the router interface is connected to different VPCs.	As interfaces de roteador especificadas como próximos saltos ao configurar roteamento ECMP não pertencem à mesma VPC.
400	OperationDenied.RouterInterfaceFromDifferentZones	The operation is not allowed because the router interface resides in different zones.	A interface de roteador pertence a uma zona diferente.
400	OperationFailed.PconnTrafficNotEnable	The operation is failed because of PconnTrafficNotEnable.	O faturamento de transferência de dados de saída está desativado.
400	ResourceNotFound.VpcPeer	The specified resource of %s is not found.	A conexão de peering VPC não foi encontrada.
400	OperationDenied.RouteTableTypeNotPermitted	The operation is not allowed because the type of route table is not permitted.	Não é permitido adicionar entradas de rota a tabelas de rotas do tipo especificado.
400	OperationDenied.GatewayRouteTableNotPermitted	The operation is not allowed to create a route pointing to this nextHop type on gateway route table.	A tabela de rotas do gateway não suporta entradas de rota que apontem para o tipo de instância especificado.
400	UnsupportedFeature.VpcPeerIpv6	IPv6 route entries for VPC peering connections cannot be created in this region.	O par da interface de roteador é uma VPC e não é possível criar uma rota cujo tipo de próximo salto seja um endereço IPv6 nesta região.
400	OperationDenied.VpcIpv6NotEnabled	IPv6 has not been enabled for the VPC.	A VPC não suporta IPv6 e a operação foi negada.
400	IncorrectStatus.Ipv4Gateway	The status of Ipv4Gateway is incorrect.	O gateway IPv4 está instável.
400	ResourceNotFound.PrefixList	The specified resource of prefixList is not found.	A lista de prefixos não existe.
400	UnsupportedFeature.CreatePrefixListEcmpRouteEntry	The feature of creating ecmp route entry with prefixList is not supported.	Não é possível criar rotas ECMP usando uma lista de prefixos.
400	OperationDenied.RouterInterfaceIpv6NotEnabled	Routerinterface does not support IPv6.	A operação falhou porque a interface de roteador não suporta IPv6.
400	OperationDenied.NextHopTypeNotPermitted	The operation is not allowed because the nextHop type is invalid.	Não é permitido criar uma rota cujo próximo salto seja deste tipo.
400	ResourceAlreadyAssociated.PrefixList	The operation failed because the specified prefixList route entry already exists.	A operação falhou porque a rota da lista de prefixos já existe.
400	OperationFailed.CidrConflictWithPrefixList	The specified CIDR block already exists in a prefixList route entry.	A rota entra em conflito com uma rota de lista de prefixos existente.
400	ResourceNotFound.Ipv4Gateway	Specified Ipv4Gateway does not exist.	O gateway IPv4 especificado não foi encontrado.
400	Mismatch.HaVipIdAndRouteTableId	The HaVip and RouteTable are mismatched.	O HAVIP e a tabela de rotas especificados não pertencem à mesma VPC.
400	OperationFailed.OperationLocked	The operation failed because the nextHop instance is in the O&M lock state.	A operação falhou porque a instância de próximo salto está bloqueada para O&M.
400	Mismatch.Ipv4GatewayIdAndRouteTableId	The specified IPv4Gateway and RouteTable are not matched.	A operação falhou porque o gateway IPv4 e a tabela de rotas não pertencem à mesma VPC.
400	OperationUnsupported.DestinationCidrBlockOverlapWithVSwitch	The destination IPv6 network segment specified in the route entry overlaps with the vSwitch network segment.	O bloco CIDR IPv6 de destino da rota sobrepõe-se ao bloco CIDR do vSwitch.
403	IncorrectInstanceStatus	The current status of the resource does not support this operation.	O recurso especificado está em um estado que não suporta a operação.
404	InvalidInstanId.NotFound	Specified instance does not exist.	A instância especificada não existe. Verifique se o ID da instância é válido.
404	InvalidNextHopId.NotFound	Specified next hop does not exist.	O próximo salto especificado não existe.
404	InvalidRouteTableId.NotFound	Specified route table does not exist.	A tabela de rotas não foi encontrada.
404	InvalidHaVipId.NotFound	The specified HaVip does not exist in the specified VPC.	O HAVIP especificado não existe na VPC.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Ocorreu um erro interno.

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