DeleteRouteEntry - Virtual Private Cloud: Central de Documentação do Alibaba Cloud

Invoca a operação DeleteRouteEntry para excluir uma rota da tabela de rotas de um vRouter ou Virtual Border Router (VBR).

Descrição da operação

Ao chamar esta operação para excluir uma rota, observe os seguintes itens:

Somente rotas no estado Available podem ser excluídas.
Uma rota não pode ser excluída enquanto a VPC que contém a tabela de rotas estiver criando ou excluindo um vSwitch ou uma rota.
Para excluir uma rota da tabela de rotas de um VBR, chame a operação DescribeRouteEntryList para consultar o NextHopId da rota que você deseja excluir e, em seguida, chame esta operação para excluir a rota.
A operação DeleteRouteEntry é assíncrona. Depois que você envia uma solicitação, o sistema retorna um ID de solicitação, mas a rota ainda não foi excluída. A tarefa de exclusão é executada em segundo plano. Você pode chamar DescribeRouteEntryList para consultar o status de exclusão da rota:
- Se a rota estiver no estado Deleting, a rota está sendo excluída.
- Se a rota especificada não puder ser encontrada, a rota foi excluída.
A operação DeleteRouteEntry não oferece suporte à exclusão simultânea de rotas da tabela de rotas dentro da mesma VPC ou VBR.

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

vpc:DeleteRouteEntry

delete

*RouteTable.

acs:vpc:{#regionId}:{#accountId}:routetable/{#RouteTableId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Não	O ID da região onde a tabela de rotas reside. Você pode chamar a operação DescribeRegions para consultar o ID da região.	cn-hangzhou
RouteTableId	string	Não	O ID da tabela de rotas que contém a rota. Nota Se o parâmetro RouteEntryId não for especificado, os parâmetros DestinationCidrBlock e RouteTableId serão obrigatórios. Configure o parâmetro NextHopId ou NextHopList conforme necessário.	vtb-2ze3jgygk9bmsj23s****
RouteEntryId	string	Não	O ID da rota que você deseja excluir. Este parâmetro é mutuamente exclusivo com o parâmetro DestinationCidrBlock. Nota Se o parâmetro DestinationCidrBlock não for especificado, o parâmetro RouteEntryId será obrigatório.	rte-bp1mnnr2al0naomnpv****
DestinationCidrBlock	string	Não	O bloco CIDR de destino da rota. Há suporte para blocos CIDR IPv4, blocos CIDR IPv6, blocos CIDR de lista de prefixos e IDs de instância de lista de prefixos. Este parâmetro é mutuamente exclusivo com o parâmetro RouteEntryId. Nota Se o parâmetro RouteEntryId não for especificado, os parâmetros DestinationCidrBlock e RouteTableId serão obrigatórios. Configure o parâmetro NextHopId ou NextHopList conforme necessário.	47.100.XX.XX/16
NextHopId	string	Não	O ID da instância do próximo salto. Para excluir uma rota não ECMP, especifique NextHopId. Não especifique NextHopList. Para excluir uma rota ECMP, especifique NextHopList. Não especifique NextHopId.	ri-2zeo3xzyf38r4urzd****
NextHopList	array<object>	Não	As informações sobre as instâncias do próximo salto da rota ECMP. Há suporte para no máximo 16 instâncias de próximo salto.
	object	Não	As informações sobre as instâncias do próximo salto da rota ECMP. Há suporte para no máximo 16 instâncias de próximo salto.
NextHopId	string	Não	O ID da instância do próximo salto da rota ECMP. Há suporte para no máximo 16 instâncias de próximo salto.	ri-2zeo3xzyf38r43cd****
NextHopType	string	Não	O tipo do próximo salto da rota ECMP. Defina o valor como RouterInterface (interface de roteador). Há suporte para no máximo 16 instâncias de próximo salto.	RouterInterface
DryRun	boolean	Não	Especifica se deve ser realizado um dry run. Valores válidos: true: realiza um dry run sem excluir a rota. O sistema verifica o par de AccessKey, a autorização do usuário do Resource Access Management (RAM) e os parâmetros obrigatórios. 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 (padrão): envia uma solicitação normal. Se a verificação for bem-sucedida, um código de status HTTP 2xx será retornado e a rota será excluída.

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	A resposta.
RequestId	string	O ID da solicitação.	0ED8D006-F706-4D23-88ED-E11ED28DCAC0

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "0ED8D006-F706-4D23-88ED-E11ED28DCAC0"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	MissingParameter	Miss mandatory parameter.
400	IncorrcetRouteEntryStatus	Some route entry status blocked this operation.
400	InvalidCidrBlock.Malformed	Specified CIDR block is not valid.
400	OperationDenied	Specified operation is denied as route entry type is system.
400	InvalidRouteEntry.NotFound	Route entry not exists.
400	InvalidVRouter.NotFound	vRouter not exists.
400	IncorrectRouteEntryStatus	Some route entry status blocked this operation.
400	Forbbiden	Specified RouteEntry cannot allowed delete by openApi.
400	InvalidNextHop	Specified nexthop and nexthop list cannot both null.
400	InvalidRouteEntry	Specified routeEntry not exist.
400	Forbidden.VRouterNotFound	pecified virtual switch is not found during access authentication.
400	TaskConflict	The operation is too frequent, TaskConflict.	As operações de EIP são muito frequentes.
400	InvalidRouteEntryId.NotFound	Specified RouteEntryId does not exist.	A entrada de rota especificada não existe.
400	IncorrectVpcStatus	Current VPC status does not support this operation.
400	InvalidVpnInstanceId.NotFound	%s
400	ParamExclusive.RouteEntryIdAndRouteTableIdOrDestCidrBlock	%s
400	InvalidNextHopList.Size	Nexthop list size should be between 2 and 16
400	ParamExclusive.NextHopIdAndList	NextHopId and NextHopList cannot both be not null.
400	OperationFailed.DeleteMultiScopeEntry	Multi or ecmp scope must delete with force.
400	OperationFailed.DistibuteLock	Distibute lock fail.	O recurso está bloqueado. Operações não são permitidas.
400	OperationDenied.DeleteManagedRouteEntry	The operation is not allowed because of route entry is managed.	Uma rota gerenciada por um serviço de nuvem não pode ser excluída.
400	OperationDenied.RouteTableTypeNotPermitted	The operation is not allowed because the type of route table is not permitted.	O tipo de tabela de rotas especificado não permite a criação de entradas de rota.
400	IncorrectStatus.VpcRouteEntry	The status of the specified routeEntry is invalid.	O status da entrada de rota da VPC é inválido.
400	OperationDenied.NextHopNotChanged	The operation is not allowed because of NextHopNotChanged.	A operação não é permitida porque o próximo salto não foi alterado.
400	OperationDenied.DeleteGatewayEndpointRoute	The operation is not allowed to delete route entry pointing gateway endpoint..	As rotas que apontam para um endpoint de gateway não podem ser excluídas manualmente.
400	IncorrectStatus.PrefixList	The status of prefixList is incorrect.	A lista de prefixos está em um estado de transição e não pode ser operada.
400	InvalidCidrBlock	Specified CIDR block is not valid.	Causas possíveis:\n1. Você não está na lista de permissões do bloco CIDR 10.0.0.0/8 e não pode usar este bloco CIDR.\n2. O bloco CIDR de destino da entrada de rota personalizada não pode ser um subconjunto do bloco CIDR de nenhum vSwitch na mesma VPC.\n3. Como o 100.64.0.0/10 é reservado para serviços em nuvem, você não pode adicionar este bloco CIDR para apontar para um data center local.\n4. Além do 100.64.0.0/10, blocos CIDR específicos, como 100.64.0.0/11 e 100.96.0.0/11, não podem ser usados para data centers locais.
400	OperationDenied.VbrAttachEcrInMiddleStatus	The operation is not allowed because of VBR attach or detach ECR in middle status.	A operação não pode ser executada porque o Roteador de Borda Virtual está em processo de carregamento ou descarregamento de um Express Connect Router (ECR). Tente novamente mais tarde.
400	UnsupportedFeature.NextHopType	The operation is not allowed because the NextHopType of specified RouteEntry is modified from Local type.	A rota atual não oferece suporte à modificação do próximo salto.
400	ResourceNotFound.PrefixList	The specified resource of prefixList is not found.	O PrefixList especificado não existe.
400	IncorrectStatus.PrefixListRelation	The related prefix list relation is in an intermediate state and cannot perform the current operation.	A associação da lista de prefixos associada está em um estado de transição. A operação atual não pode ser executada.
500	Vpc.Error	error code 500,Internal server error.
500	Internal.Error	The request processing has failed due to some unknown error, exception or failure.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	O processamento da solicitação falhou devido a um erro desconhecido.
404	InvalidRouteTableId.NotFound	Specified route table does not exist.
404	InvalidVpcId.NotFound	Specified value of VpcId is not found in our record.	A VPC não existe. Verifique se a VPC especificada está correta.
404	ResourceNotFound.GatewayLoadBalancerEndpoint	GatewayLoadBalancerEndpoint instance not found.	A instância GatewayLoadBalancerEndpoint não foi encontrada.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.