Todos os produtos
Search
Central de documentação

:DeleteTransitRouterRouteEntry

Última atualização: Jul 03, 2026

Exclui uma rota estática de uma tabela de rotas de um roteador de trânsito Enterprise Edition.

Observações de uso

Antes de chamar esta operação, observe os seguintes itens:

  • Se TransitRouterRouteEntryId estiver definido, não especifique TransitRouterRouteTableId nem TransitRouterRouteEntryDestinationCidrBlock. Caso contrário, ocorrerão conflitos de parâmetros.
  • Se TransitRouterRouteEntryId não estiver definido, especifique os seguintes parâmetros de acordo com o tipo de próximo salto:
    • Para excluir uma rota black hole, defina TransitRouterRouteTableId, TransitRouterRouteEntryDestinationCidrBlock e TransitRouterRouteEntryNextHopType.
    • Se a rota que você deseja excluir não for uma rota black hole, defina TransitRouterRouteTableId, TransitRouterRouteEntryDestinationCidrBlock, TransitRouterRouteEntryNextHopType e TransitRouterRouteEntryNextHopId.
  • DeleteTransitRouterRouteEntry é uma operação assíncrona. Após enviar a solicitação, o sistema retorna o ID da solicitação, mas a operação continua em execução em segundo plano. Chame ListTransitRouterRouteEntries para consultar o status de uma entrada de rota.
    • Se uma entrada de rota estiver no estado Deleting, ela está sendo excluída. Você pode consultar a entrada de rota, mas não pode executar outras operações.
    • Se a entrada de rota não for encontrada, ela foi excluída.

Limites

Esta operação exclui apenas rotas estáticas. Rotas aprendidas automaticamente não são suportadas. Chame a operação ListTransitRouterRouteEntries para consultar os tipos de rota.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar 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 DeleteTransitRouterRouteEntry

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

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 valor, mas garanta que ele seja exclusivo entre diferentes solicitações. O ClientToken pode conter apenas caracteres ASCII.

Nota Se você não definir este parâmetro, o ClientToken receberá o valor de RequestId. O valor de RequestId pode ser diferente para cada solicitação de API.
DryRun Boolean Não false

Especifica se deve ser feita uma verificação prévia para validar informações como permissões e status da instância. Valores válidos:

  • false (padrão): envia a solicitação. Se a solicitação passar na verificação prévia, a rota será excluída.
  • true: envia uma solicitação de verificação prévia. A rota não é excluída após a aprovação na verificação. O sistema verifica os parâmetros obrigatórios e a sintaxe da solicitação. Se a solicitação não passar na verificação, uma mensagem de erro será retornada. Se passar, o sistema retorna o ID da solicitação.
TransitRouterRouteEntryId String Não rte-75eg4jprkvk0pw****

O ID da entrada de rota.

TransitRouterRouteEntryNextHopType String Não BlackHole

O tipo de próximo salto. Valores válidos:

  • BlackHole: rota black hole. Não é necessário especificar um próximo salto.
  • Attachment: conexão de instância de rede. Especifique uma conexão de instância de rede como próximo salto.
TransitRouterRouteEntryDestinationCidrBlock String Não 192.168.0.0/24

O bloco CIDR de destino.

TransitRouterRouteEntryNextHopId String Não tr-attach-nls9fzkfat8934****

O ID da conexão de instância de rede a ser especificada como próximo salto.

TransitRouterRouteTableId String Não vtb-bp1dudbh2d5na6b50****

O ID da tabela de rotas do roteador de trânsito Enterprise Edition.

Parâmetros de resposta

Parâmetro Tipo Exemplo Descrição
RequestId String 2D69CCEA-42D0-48B2-8C9A-9BB207F76D6E

O ID da solicitação.

Exemplos

Solicitações de exemplo

http(s)://[Endpoint]/?Action=DeleteTransitRouterRouteEntry
&ClientToken=02fb3da4-130e-11e9-8e44-001****
&DryRun=false
&TransitRouterRouteEntryId=rte-75eg4jprkvk0pw****
&TransitRouterRouteEntryNextHopType=BlackHole
&TransitRouterRouteEntryDestinationCidrBlock=192.168.0.0/24
&TransitRouterRouteTableId=vtb-bp1dudbh2d5na6b50****
&Common request parameters

Respostas de sucesso de exemplo

Formato XML

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

<DeleteTransitRouterRouteEntryResponse>
    <RequestId>2D69CCEA-42D0-48B2-8C9A-9BB207F76D6E</RequestId>
</DeleteTransitRouterRouteEntryResponse>

Formato JSON

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

{
  "RequestId" : "2D69CCEA-42D0-48B2-8C9A-9BB207F76D6E"
}

Códigos de erro

HttpCode Código de erro Mensagem de erro Descrição
400 DryRunOperation Request validation has been passed with DryRun flag set. Mensagem de erro retornada porque a solicitação de teste passou na verificação prévia.

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