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:
-
Não há conexões de instância de rede associadas ao transit router.
Para obter detalhes sobre como excluir uma conexão de Virtual Private Cloud (VPC), consulte DeleteTransitRouterVpcAttachment.
Para saber mais sobre a exclusão de uma conexão de Virtual Border Router (VBR), veja DeleteTransitRouterVbrAttachment.
Caso precise remover uma conexão de Cloud Connect Network (CCN), acesse DetachCenChildInstance.
Para instruções sobre como excluir uma conexão VPN, consulte DeleteTransitRouterVpnAttachment.
Para excluir uma conexão inter-região, veja DeleteTransitRouterPeerAttachment.
O transit router não possui tabelas de rotas personalizadas. Para mais informações sobre como excluir uma tabela de rotas personalizada, consulte DeleteTransitRouterRouteTable.
Depuração
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:
|
| 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.