Todos os produtos
Search
Central de documentação

:ListTransitRouterRouteEntries

Última atualização: Jul 03, 2026

Consulta as rotas em uma tabela de rotas de um roteador de trânsito da Enterprise Edition.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

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

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

MaxResults Integer Não 20

Número de entradas retornadas por página. Valores válidos: 1 a 100. Valor padrão: 20.

TransitRouterRouteEntryDestinationCidrBlock String Não 192.168.0.0/24

Bloco CIDR de destino da rota.

TransitRouterRouteEntryStatus String Não Active

Status da rota. Valores válidos:

  • Creating: a rota está sendo criada.
  • Active: a regra está disponível.
  • Deleting: a regra está sendo excluída.
TransitRouterRouteTableId String Sim vtb-bp1dudbh2d5na6b50****

ID da tabela de rotas do roteador de trânsito da Enterprise Edition.

NextToken String Não fce19****

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

  • Ignore este parâmetro se esta for a primeira consulta ou se não houver consultas subsequentes.
  • Para enviar uma consulta subsequente, defina o valor como o NextToken retornado na última chamada.
TransitRouterRouteEntryNames.N String Não testname

Nome da rota.

O nome deve ter de 0 a 128 caracteres e pode conter letras, dígitos e os seguintes caracteres especiais: , . ; / @ _ -.

Especifique até 20 nomes de rotas em cada chamada.

Nota Esta operação consulta apenas rotas estáticas.
TransitRouterRouteEntryIds.N String Não rte-oklkgwmj97z6dn****

ID da rota.

Especifique até 20 IDs de rotas em cada chamada.

Nota Esta operação consulta apenas rotas estáticas.

Parâmetros de resposta

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

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

  • A ausência do NextToken indica que não há resultados adicionais.
  • Se a consulta anterior retornou um NextToken, especifique esse valor para obter o próximo conjunto de resultados.
RequestId String C3835E5E-1504-4344-B1BB-98A4110F1079

ID da solicitação.

TotalCount Integer 6

Número total de entradas retornadas.

MaxResults Integer 20

Número de entradas retornadas por página.

TransitRouterRouteEntries Array of TransitRouterRouteEntry

Lista de rotas.

TransitRouterRouteEntryId String rte-oklkgwmj97z6dn****

ID da rota.

Nota Retornado apenas para rotas estáticas.
TransitRouterRouteEntryDestinationCidrBlock String 192.168.0.0/24

Bloco CIDR de destino da rota.

TransitRouterRouteEntryType String Static

Tipo da rota. Valores válidos:

  • Static: rota estática.
  • Propagated: rota aprendida automaticamente.
CreateTime String 2021-06-15T07:01Z

Horário de criação da rota.

Segue o padrão ISO8601 no formato AAAA-MM-DDThh:mmZ, exibido em UTC.

Nota Retornado apenas para rotas estáticas.
TransitRouterRouteEntryName String testname

Nome da rota.

Nota Retornado apenas para rotas estáticas.
TransitRouterRouteEntryStatus String Active

Status da rota. Valores válidos:

  • Creating: a rota está sendo criada.
  • Active: a regra está disponível.
  • Deleting: a regra está sendo excluída.
TransitRouterRouteEntryNextHopType String BlackHole

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

  • BlackHole: rota blackhole. Descarta pacotes destinados ao bloco CIDR de destino da rota.
  • Attachment: conexão de instância de rede. Encaminha pacotes destinados ao bloco CIDR de destino da rota para a conexão de instância de rede especificada.
TransitRouterRouteEntryNextHopId String tr-attach-vx6iwhjr1x1j78****

ID do próximo salto.

TransitRouterRouteEntryDescription String CidrRoute

Descrição da rota.

Nota Retornado apenas para rotas estáticas.
OperationalMode Boolean false

Indica se a rota é gerenciável. Valores válidos:

  • true: a rota é gerenciável e pode ser excluída.
  • false: a rota não é gerenciável pois foi gerada automaticamente pelo sistema.
Tag String PermitVbr

Tag da rota.

Valor válido: PermitVbr. Indica que a rota é anunciada apenas para a tabela de rotas do roteador de borda virtual (VBR) conectado ao roteador de trânsito.

Nota Retornado apenas para rotas geradas automaticamente pelo sistema que utilizam endereços IP do bloco CIDR do roteador de trânsito.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=ListTransitRouterRouteEntries
&MaxResults=20
&TransitRouterRouteEntryDestinationCidrBlock=192.168.0.0/24
&TransitRouterRouteEntryStatus=Active
&TransitRouterRouteTableId=vtb-bp1dudbh2d5na6b50****
&NextToken=fce19****
&TransitRouterRouteEntryNames=["testname"]
&TransitRouterRouteEntryIds=["rte-oklkgwmj97z6dn****"]
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<ListTransitRouterRouteEntriesResponse>
    <NextToken>fce19****</NextToken>
    <RequestId>C3835E5E-1504-4344-B1BB-98A4110F1079</RequestId>
    <TotalCount>6</TotalCount>
    <MaxResults>20</MaxResults>
    <TransitRouterRouteEntries>
        <TransitRouterRouteEntryId>rte-oklkgwmj97z6dn****</TransitRouterRouteEntryId>
        <TransitRouterRouteEntryDestinationCidrBlock>192.168.0.0/24</TransitRouterRouteEntryDestinationCidrBlock>
        <TransitRouterRouteEntryType>Static</TransitRouterRouteEntryType>
        <CreateTime>2021-06-15T07:01Z</CreateTime>
        <TransitRouterRouteEntryName>testname</TransitRouterRouteEntryName>
        <TransitRouterRouteEntryStatus>Active</TransitRouterRouteEntryStatus>
        <TransitRouterRouteEntryNextHopType>BlackHole</TransitRouterRouteEntryNextHopType>
        <TransitRouterRouteEntryNextHopId>tr-attach-vx6iwhjr1x1j78****</TransitRouterRouteEntryNextHopId>
        <TransitRouterRouteEntryDescription>CidrRoute</TransitRouterRouteEntryDescription>
        <OperationalMode>false</OperationalMode>
        <Tag>PermitVbr</Tag>
    </TransitRouterRouteEntries>
</ListTransitRouterRouteEntriesResponse>

Formato JSON

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

{
  "NextToken" : "fce19****",
  "RequestId" : "C3835E5E-1504-4344-B1BB-98A4110F1079",
  "TotalCount" : 6,
  "MaxResults" : 20,
  "TransitRouterRouteEntries" : [ {
    "TransitRouterRouteEntryId" : "rte-oklkgwmj97z6dn****",
    "TransitRouterRouteEntryDestinationCidrBlock" : "192.168.0.0/24",
    "TransitRouterRouteEntryType" : "Static",
    "CreateTime" : "2021-06-15T07:01Z",
    "TransitRouterRouteEntryName" : "testname",
    "TransitRouterRouteEntryStatus" : "Active",
    "TransitRouterRouteEntryNextHopType" : "BlackHole",
    "TransitRouterRouteEntryDescription" : "CidrRoute",
    "OperationalMode" : false,
    "Tag" : "PermitVbr"
  } ]
}

Códigos de erro

HttpCode

Código de erro

Mensagem de erro

Descrição

400

InvalidTransitRouterRouteTableId.NotFound

TransitRouterRouteTableId is not found.

O ID da tabela de rotas do roteador de trânsito especificado não existe.

Para obter uma lista de códigos de erro, visite o Centro de Erros de API.