Todos os produtos
Search
Central de documentação

:DeleteRouteEntry

Última atualização: Jul 04, 2026

Exclui uma rota de uma tabela de rotas de um vRouter ou virtual border router (VBR).

Observações de uso

Ao chamar esta operação, observe as seguintes regras:

  • Somente rotas no estado Available podem ser excluídas.

  • Não é possível excluir uma rota de uma virtual private cloud (VPC) enquanto um vSwitch ou uma rota estiver sendo criado.

  • Para excluir uma rota da tabela de rotas de um VBR, consulte o NextHopId chamando a operação DescribeRouteEntryList. Em seguida, chame esta operação para excluir a rota.

  • A operação DeleteRouteEntry é assíncrona. Após o envio da solicitação, o sistema retorna um ID de solicitação e executa a tarefa em segundo plano. Chame a operação DescribeRouteEntryList para consultar o status da tarefa.

    • Se a rota estiver no estado Deleting, ela está sendo excluída.

    • Caso não seja possível consultar a rota, significa que ela foi excluída.

  • Evite chamar a operação DeleteRouteEntry repetidamente em um curto período.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos que você chame esta operação no OpenAPI Explorer. 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 DeleteRouteEntry

A operação a ser executada. Defina o valor como DeleteRouteEntry.

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 Não vtb-2ze3jgygk9bmsj23s****

O ID da tabela de rotas à qual a rota pertence.

RouteEntryId String Sim rte-bp1mnnr2al0naomnpv****

O ID da rota a ser excluída.

DestinationCidrBlock String Não 47.100.XX.XX/16

O bloco CIDR de destino da rota. Há suporte para blocos CIDR IPv4 e IPv6.

NextHopId String Não ri-2zeo3xzyf38r4urzd****

O ID do próximo salto.

  • Para excluir uma rota não ECMP, especifique NextHopId e ignore NextHopList.
  • Para excluir uma rota ECMP, especifique NextHopList e ignore NextHopId.
NextHopList.N.NextHopId String Não ri-2zeo3xzyf38r43cd****

O ID do próximo salto configurado para roteamento ECMP. É possível especificar informações de até 16 próximos saltos.

NextHopList.N.NextHopType String Não RouterInterface

O tipo do próximo salto da rota ECMP. Defina o valor como RouterInterface. É possível especificar informações de até 16 próximos saltos.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

RequestId

String

0ED8D006-F706-4D23-88ED-E11ED28DCAC0

O ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=DeleteRouteEntry
&RegionId=cn-hangzhou
&RouteTableId=vtb-2ze3jgygk9bmsj23s****
&RouteEntryId=rte-bp1mnnr2al0naomnpv****
&DestinationCidrBlock=47.100.XX.XX/16
&NextHopId=ri-2zeo3xzyf38r4urzd****
&NextHopList=[{"NextHopId":"ri-2zeo3xzyf38r43cd****","NextHopType":"RouterInterface"}]
&Common request parameters

Exemplos de respostas de sucesso

Formato XML

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

<DeleteRouteEntryResponse>
    <RequestId>0ED8D006-F706-4D23-88ED-E11ED28DCAC0</RequestId>
</DeleteRouteEntryResponse>

Formato JSON

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

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

Códigos de erro

HttpCode

Código de erro

Mensagem de erro

Descrição

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

IncorrcetRouteEntryStatus

Some route entry status blocked this operation.

Uma ou mais rotas na tabela de rotas estão no estado Pending ou Modifying.

400

InvalidCidrBlock.Malformed

Specified CIDR block is not valid.

O formato do bloco CIDR especificado é inválido.

400

OperationDenied

Specified operation is denied as route entry type is system.

A rota especificada é uma rota de sistema.

400

InvalidRouteEntry.NotFound

Route entry not exists.

A rota não existe.

400

InvalidVRouter.NotFound

vRouter not exists.

O vRouter especificado não existe. Verifique se o vRouter informado é válido.

400

IncorrectRouteEntryStatus

Some route entry status blocked this operation.

Uma ou mais rotas na tabela de rotas atual estão no estado Pending ou Modifying.

400

IncorrectRouteEntryStatus

VBR has NotStable route entry.

Uma ou mais rotas no VBR atual estão no estado Pending ou Modifying.

400

IncorrectRouteEntryStatus

Specified routeEntry status error.

Uma ou mais rotas na tabela de rotas atual estão no estado Pending ou Modifying.

400

Forbbiden

Specified RouteEntry cannot allowed delete by openApi.

Não é possível usar esta operação para excluir a rota especificada.

400

InvalidNextHop

Specified nexthop and nexthop list cannot both null.

O próximo salto e a lista de próximos saltos não podem estar vazios simultaneamente.

400

InvalidRouteEntry

Specified routeEntry not exist.

A rota especificada não existe.

400

TaskConflict

The operation is too frequent, TaskConflict.

O sistema está indisponível. Tente novamente mais tarde.

400

InvalidRouteEntryId.NotFound

Specified RouteEntryId does not exist.

A rota especificada não existe.

400

IncorrectVpcStatus

Current VPC status does not support this operation.

Esta operação não pode ser executada quando a VPC está no estado atual.

400

OperationDenied.DeleteManagedRouteEntry

The operation is not allowed because of route entry is managed.

Não é possível excluir rotas gerenciadas.

400

OperationDenied.RouteTableTypeNotPermitted

The operation is not allowed because the type of route table is not permitted.

Não é possível adicionar rotas a tabelas de rotas do tipo especificado.

400

IncorrectStatus.VpcRouteEntry

The status of the specified routeEntry is invalid.

O status da rota da VPC é inválido.

404

InvalidRouteTableId.NotFound

Specified route table does not exist.

A tabela de rotas não foi encontrada.

404

InvalidVpcId.NotFound

Specified value of VpcId is not found in our record.

A VPC não foi encontrada.

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