Todos os produtos
Search
Central de documentação

:DeleteTransitRouter

Última atualização: Jul 03, 2026

Exclui um transit router.

Observações de uso

A operação DeleteTransitRouter é assíncrona. Após o envio da solicitação, o sistema retorna o request ID, mas a execução continua em segundo plano. Para consultar o status do transit router, chame a API ListTransitRouters.

  • Se o transit router estiver no estado Deleting, ele estará em processo de exclusão. Nesse caso, você pode consultá-lo, mas não pode executar outras operações.

  • Se o transit router não for encontrado, significa que a exclusão foi concluída.

Pré-requisitos

Antes de excluir um transit router, verifique se os seguintes pré-requisitos foram atendidos:

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para sua conveniência. 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 DeleteTransitRouter

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

ClientToken String Não 02fb3da4-130e-11e9-8e44-001****

O token do cliente usado para garantir a idempotência da solicitação.

Use o cliente para gerar esse valor e garanta que seja único entre diferentes solicitações. O ClientToken aceita apenas caracteres ASCII.

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

Define se a solicitação deve passar apenas por uma pré-verificação. Os itens verificados incluem permissões e o status do transit router. Valores válidos:

  • false (padrão): envia a solicitação. Se a pré-verificação for aprovada, o transit router será excluído.
  • true: realiza a pré-verificação sem excluir o transit router. Ao usar este valor, o sistema valida os parâmetros obrigatórios e a sintaxe da solicitação. Caso a validação falhe, o sistema retornará uma mensagem de erro. Se a pré-verificação for bem-sucedida, o sistema retornará o código de erro DryRunOperation.
TransitRouterId String Sim tr-uf654ttymmljlvh2x****

O ID do transit router.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

RequestId

String

6DE3EE92-39C8-4BBD-A3AD-F568D74741BB

O ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=DeleteTransitRouter
&ClientToken=02fb3da4-130e-11e9-8e44-001****
&DryRun=false
&TransitRouterId=tr-uf654ttymmljlvh2x****
&Common request parameters

Exemplos de respostas de sucesso

Formato XML

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

<DeleteTransitRouterResponse>
    <RequestId>6DE3EE92-39C8-4BBD-A3AD-F568D74741BB</RequestId>
</DeleteTransitRouterResponse>

Formato JSON

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

{
  "RequestId" : "6DE3EE92-39C8-4BBD-A3AD-F568D74741BB"
}

Códigos de erro

HttpCode

Códigos de erro

Mensagem de erro

Descrição

400

OperationFailed.DeleteTransitRouter

Operation failed because TransitRouterRouteEntry exists

A mensagem de erro indica que o transit router especificado não pode ser excluído porque existem entradas de rota configuradas nele.

400

OperationFailed.DeleteTransitRouter

Operation failed because TransitRouterRouteTable exists

A mensagem de erro indica que o transit router especificado não pode ser excluído porque há tabelas de rotas personalizadas associadas a ele.

400

IncorrectStatus.TransitRouterInstance

The status of TransitRouter is incorrect.

A mensagem de erro indica que o transit router não pode ser excluído no estado atual.

400

OperationFailed.BandwidthLimitExist

Operation is invalid because a bandwidth limit exist.

A mensagem de erro indica que o transit router não pode ser excluído enquanto o limitador de largura de banda estiver ativado.

Para obter uma lista de códigos de erro, visite o API Error Center.