Todos os produtos
Search
Central de documentação

:ListTransitRouterRouteTableAssociations

Última atualização: Jul 03, 2026

Consulta as correlações de encaminhamento associadas a uma tabela de rotas de um transit router da Enterprise Edition ou a uma conexão de instância de rede.

Observações de uso

Ao chamar ListTransitRouterRouteTableAssociations, defina pelo menos um dos parâmetros: TransitRouterRouteTableId ou TransitRouterAttachmentId.

  • Se definir apenas TransitRouterRouteTableId, a API consulta as conexões de instância de rede com correlação de encaminhamento associada a uma tabela de rotas de um transit router da Enterprise Edition.

  • Se definir apenas TransitRouterAttachmentId, o sistema consulta a tabela de rotas de um transit router da Enterprise Edition com correlação de encaminhamento associada a uma conexão de instância de rede.

  • Se especificar ambos os parâmetros TransitRouterRouteTableId e TransitRouterAttachmentId, a operação retorna as correlações de encaminhamento entre a conexão de instância de rede e a tabela de rotas do transit router da Enterprise Edition indicadas.

    • Caso exista uma correlação de encaminhamento entre a conexão de instância de rede e a tabela de rotas do transit router da Enterprise Edition, as informações sobre essa correlação serão retornadas.

    • Se não houver correlação de encaminhamento entre a conexão de instância de rede e a tabela de rotas do transit router da Enterprise Edition, o campo TransitRouterAssociations na resposta estará vazio.

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 ListTransitRouterRouteTableAssociations

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

MaxResults Integer Não 50

Número de entradas a serem retornadas em cada página. Valor padrão: 50.

NextToken String Não a415****

Token que determina o ponto inicial da consulta. Valores válidos:

  • Se esta for a primeira consulta ou se nenhuma consulta subsequente for enviada, ignore este parâmetro.
  • Para enviar uma consulta subsequente, defina o valor como o valor de NextToken retornado na última chamada.
TransitRouterRouteTableId String Não vtb-bp1dudbh2d5na6b50****

ID da tabela de rotas do transit router da Enterprise Edition.

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

ID da conexão de instância de rede.

Parâmetros de resposta

Parâmetro Tipo Exemplo Descrição
NextToken String a415****

Token que determina o ponto inicial da consulta. Valores válidos:

  • Se NextToken não for retornado, não existem resultados adicionais.
  • Se NextToken tiver sido retornado na consulta anterior, especifique o valor para obter o próximo conjunto de resultados.
RequestId String F6B1D9AB-176D-4399-801D-8BC576F4EB0D

ID da solicitação.

TotalCount Integer 1

Número total de entradas retornadas.

MaxResults Integer 50

Quantidade de entradas retornadas em cada página.

TransitRouterAssociations Array of TransitRouterAssociation

Lista de correlações de encaminhamento associadas.

TransitRouterAttachmentId String tr-attach-nls9fzkfat8934****

ID da conexão de instância de rede.

Status String Associating

Estado da correlação de encaminhamento associada. Valores válidos:

  • Active: A correlação de encaminhamento associada está disponível.
  • Associating: A correlação de encaminhamento associada está sendo criada.
  • Dissociating: A correlação de encaminhamento associada está sendo removida.
  • Deleted: A correlação de encaminhamento associada foi removida.
ResourceType String VPC

Tipo do próximo salto. Valores válidos:

  • VPC: virtual private cloud (VPC)
  • VBR: virtual border router (VBR)
  • TR: transit router
  • VPN: conexão IPsec-VPN
ResourceId String vpc-bp1h8vbrbcgohcju5****

ID do próximo salto.

TransitRouterRouteTableId String vtb-bp1dudbh2d5na6b50****

ID da tabela de rotas do transit router da Enterprise Edition.

Exemplos

Solicitações de exemplo

http(s)://[Endpoint]/?Action=ListTransitRouterRouteTableAssociations
&MaxResults=50
&TransitRouterRouteTableId=vtb-bp1dudbh2d5na6b50****
&TransitRouterAttachmentId=tr-attach-nls9fzkfat8934****
&<Common request parameters>

Respostas de sucesso de exemplo

Formato XML

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

<ListTransitRouterRouteTableAssociationsResponse>
    <RequestId>F6B1D9AB-176D-4399-801D-8BC576F4EB0D</RequestId>
    <TotalCount>1</TotalCount>
    <MaxResults>50</MaxResults>
    <TransitRouterAssociations>
        <TransitRouterAttachmentId>tr-attach-nls9fzkfat8934****</TransitRouterAttachmentId>
        <Status>Associating</Status>
        <ResourceType>VPC</ResourceType>
        <ResourceId>vpc-bp1h8vbrbcgohcju5****</ResourceId>
        <TransitRouterRouteTableId>vtb-bp1dudbh2d5na6b50****</TransitRouterRouteTableId>
    </TransitRouterAssociations>
</ListTransitRouterRouteTableAssociationsResponse>

Formato JSON

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

{
  "RequestId" : "F6B1D9AB-176D-4399-801D-8BC576F4EB0D",
  "TotalCount" : 1,
  "MaxResults" : 50,
  "TransitRouterAssociations" : [ {
    "TransitRouterAttachmentId" : "tr-attach-nls9fzkfat8934****",
    "Status" : "Associating",
    "ResourceType" : "VPC",
    "ResourceId" : "vpc-bp1h8vbrbcgohcju5****",
    "TransitRouterRouteTableId" : "vtb-bp1dudbh2d5na6b50****"
  } ]
}

Códigos de erro

HttpCode

Código de erro

Mensagem de erro

Descrição

400

IllegalParam.NextToken

The parameter NextToken is invalid.

Mensagem de erro retornada porque NextToken foi definido com um valor inválido. Especifique um token válido e tente novamente.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.