Todos os produtos
Search
Central de documentação

:DeleteTransitRouterPeerAttachment

Última atualização: Jul 03, 2026

Exclui uma conexão inter-região de um transit router da Enterprise Edition.

Observações de uso

A operação DeleteTransitRouterPeerAttachment é assíncrona. Após o envio da solicitação, o sistema retorna o ID da solicitação, mas a execução continua em segundo plano. Para consultar o status de uma conexão inter-região, chame a operação ListTransitRouterPeerAttachments.

  • Se a conexão inter-região estiver no estado Detaching, ela estará sendo excluída. Nesse cenário, consulte a conexão, mas não execute outras operações.

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

Pré-requisitos

Antes de começar, verifique se o transit router da Enterprise Edition usado para criar conexões inter-região atende aos seguintes pré-requisitos:

  • Não há correlação de encaminhamento associada entre a conexão inter-região e as tabelas de rotas do transit router da Enterprise Edition. Para obter mais informações sobre como excluir essa correlação, consulte DissociateTransitRouterAttachmentFromRouteTable.

  • Não há correlação de aprendizado de rotas entre a conexão inter-região e as tabelas de rotas do transit router da Enterprise Edition. Para saber como remover essa correlação, consulte DisableTransitRouterRouteTablePropagation.

  • As tabelas de rotas do transit router da Enterprise Edition não contêm entradas de rota personalizadas cujo próximo salto seja a conexão da instância de rede. Para obter detalhes sobre como excluir rotas personalizadas nessas tabelas, consulte DeleteTransitRouterRouteEntry.

  • A tabela de rotas não contém rotas geradas a partir de uma lista de prefixos que tenham a conexão inter-região como próximo salto. Remova essas rotas ao desassociar a tabela de rotas da lista de prefixos. Para mais informações, consulte DeleteTransitRouterPrefixListAssociation.

  • Nenhuma política de qualidade de serviço (QoS) está configurada para a conexão inter-região. Para obter instruções sobre como excluir políticas de QoS, consulte DeleteCenInterRegionTrafficQosPolicy.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. 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 DeleteTransitRouterPeerAttachment

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

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 esse valor e garanta que ele 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.
TransitRouterAttachmentId String Sim tr-attach-gyjhtx9sjsxhm6****

O ID da conexão inter-região.

DryRun Boolean Não false

Especifica se deve executar apenas a pré-verificação da solicitaçã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, a conexão inter-região será excluída.
  • true: envia uma solicitação apenas para pré-verificação. A conexão inter-região não é excluída mesmo após a aprovação na pré-verificação. Ao usar este valor, o sistema valida os parâmetros obrigatórios e a sintaxe da solicitação. Em caso de falha na pré-verificação, o sistema retorna uma mensagem de erro. Se a verificação for bem-sucedida, o sistema retorna o ID da solicitação.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

RequestId

String

A01FEDD7-7D69-4EB3-996D-CF79F6F885CA

O ID da solicitação.

Exemplos

Exemplos de solicitações

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

Exemplos de respostas de sucesso

Formato XML

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

<DeleteTransitRouterPeerAttachmentResponse>
    <RequestId>A01FEDD7-7D69-4EB3-996D-CF79F6F885CA</RequestId>
</DeleteTransitRouterPeerAttachmentResponse>

Formato JSON

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

{
  "RequestId" : "A01FEDD7-7D69-4EB3-996D-CF79F6F885CA"
}

Códigos de erro

HttpCode

Código de erro

Mensagem de erro

Descrição

400

OperationFailed.RouteEntryExist

Operation failed because the TransitRouterAttachment exists in RouteTable.

Mensagem de erro retornada porque a operação não pode ser executada quando a conexão inter-região especificada é definida como o próximo salto de uma ou mais rotas na tabela de rotas.

400

OperationFailed.RouteTableAssociationExist

Operation failed because TransitRouterRouteTable exists

Mensagem de erro retornada porque a operação não pode ser executada quando a conexão está associada a uma tabela de rotas.

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