Todos os produtos
Search
Central de documentação

:DeleteTransitRouterVbrAttachment

Última atualização: Jul 03, 2026

Exclui uma conexão de virtual border router (VBR) de um transit router Enterprise Edition.

Observações de uso

A operação DeleteTransitRouterVbrAttachment é 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 da conexão VBR, chame a operação ListTransitRouterVbrAttachments.

  • Se a conexão VBR estiver no estado Detaching, ela estará em processo de exclusão. Nesse cenário, consulte a conexão, mas não execute outras operações.

  • Se a conexão VBR não for encontrada, significa que ela já foi excluída.

Pré-requisitos

Antes de excluir uma conexão VBR de um transit router Enterprise Edition, verifique se os seguintes requisitos foram atendidos:

  • Não deve existir correlação de encaminhamento associada entre a conexão VBR e as tabelas de rotas do transit router Enterprise Edition. Para obter mais informações sobre como remover essa correlação, consulte DissociateTransitRouterAttachmentFromRouteTable.

  • Não deve haver correlação de aprendizado de rotas estabelecida entre a conexão VBR e as tabelas de rotas do transit router Enterprise Edition. Para saber como desativar o aprendizado de rotas, veja DisableTransitRouterRouteTablePropagation.

  • As tabelas de rotas do transit router Enterprise Edition não podem conter entradas de rota personalizadas cujo próximo salto seja a conexão da instância de rede. Para detalhes sobre a exclusão de entradas de rota personalizadas, acesse DeleteTransitRouterRouteEntry.

  • As tabelas de rotas do transit router Enterprise Edition não devem possuir rotas geradas a partir de uma lista de prefixos que apontem para a conexão VBR como próximo salto. Remova essas rotas desassociando a tabela de rotas da lista de prefixos. Para mais informações, consulte DeleteTransitRouterPrefixListAssociation.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação diretamente no OpenAPI Explorer, que também gera dinamicamente exemplos de código para diferentes SDKs.

Parâmetros da solicitação

Parâmetro Tipo Obrigatório Exemplo Descrição
Action String Sim DeleteTransitRouterVbrAttachment

Operação a ser executada. Defina o valor como DeleteTransitRouterVbrAttachment.

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

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

Gere esse valor no cliente, garantindo que seja único para cada solicitação distinta. O ClientToken aceita apenas caracteres ASCII.

Nota Caso você não defina este parâmetro, o ClientToken assumirá automaticamente o valor do RequestId. O valor do RequestId pode variar a cada chamada de API.
TransitRouterAttachmentId String Sim tr-attach-9nlnjv7by7n7a****

ID da conexão VBR.

DryRun Boolean Não false

Define se uma pré-verificação deve ser executada para validar permissões e o status da instância. Valores válidos:

  • false (padrão): envia a solicitação normalmente. Se a pré-verificação for aprovada, a conexão VBR será excluída.
  • true: realiza apenas a pré-verificação sem excluir a conexão VBR. Ao usar esta opção, o sistema valida os parâmetros obrigatórios e a sintaxe da solicitação. Em caso de falha na validação, o sistema retorna uma mensagem de erro. Se a verificação for bem-sucedida, o sistema retorna apenas o ID da solicitação.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

RequestId

String

3EDA94DE-0AE5-41FC-A91E-7170E408E0FD

ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=DeleteTransitRouterVbrAttachment
&ClientToken=02fb3da4-130e-11e9-8e44-001****
&TransitRouterAttachmentId=tr-attach-9nlnjv7by7n7a****
&DryRun=false
&Common request parameters

Exemplos de respostas de sucesso

Formato XML

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

<DeleteTransitRouterVbrAttachmentResponse> 
<RequestId>3EDA94DE-0AE5-41FC-A91E-7170E408E0FD</RequestId>
</DeleteTransitRouterVbrAttachmentResponse>

Formato JSON

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

{
  "RequestId" : "3EDA94DE-0AE5-41FC-A91E-7170E408E0FD"
}

Códigos de erro

HttpCode

Códigos de erro

Mensagem de erro

Descrição

400

OperationFailed.RouteTableAssociationExist

Operation failed because TransitRouterRouteTable exists

Mensagem retornada quando a operação não pode ser concluída devido à existência de uma correlação de encaminhamento associada.

400

OperationFailed.RouteEntryExist

Operation failed because the TransitRouterAttachment exists in RouteTable.

Mensagem retornada quando a conexão inter-regiões especificada está configurada como próximo salto em uma ou mais rotas da tabela de rotas, impedindo a execução da operação.

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