Todos os produtos
Search
Central de documentação

:DescribeRouteTableList

Última atualização: Jul 03, 2026

Consulta tabelas de rotas.

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 de solicitação

Parameter

Type

Required

Example

Description

RouterType String No VRouter

Tipo do roteador ao qual a tabela de rotas pertence. Valor válido:

  • VRouter (padrão)
  • VBR
RouterId String No vrt-bp1lhl0taikrteen8****

ID do roteador ao qual a tabela de rotas pertence.

VpcId String No vpc-bp15zckdt37pq72****

ID da Virtual Private Cloud (VPC) à qual a tabela de rotas pertence.

Ao especificar este parâmetro, o sistema define automaticamente o valor do parâmetro RouterType como VRouter.

RouteTableId String No vtb-bp145q7glnuzdvzu2****

ID da tabela de rotas a ser consultada.

RouteTableName String No doctest

Nome da tabela de rotas a ser consultada.

PageNumber Integer No 1

Número da página. Valor padrão: 1.

PageSize Integer No 10

Quantidade de entradas por página. Valor máximo: 50. Valor padrão: 10.

ResourceGroupId String No rg-acfmxazb4ph****

ID do grupo de recursos ao qual a tabela de rotas consultada pertence.

Action String Yes DescribeRouteTableList

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

RegionId String Yes ap-southeast-6

ID da região da VPC à qual a tabela de rotas pertence.

Chame a operação DescribeRegions para consultar a lista de regiões mais recente.

Tag.N.Key String No FinanceDept

Chave da tag N a ser adicionada ao recurso. É possível especificar até 20 chaves de tag. A chave não pode ser uma string vazia.

A chave da tag pode ter no máximo 128 caracteres. Ela não pode começar com aliyun ou acs:, nem conter http:// ou https://.

Tag.N.Value String No FinanceJoshua

Valor da tag N a ser adicionado ao recurso. É possível especificar até 20 valores de tag. O valor pode ser uma string vazia.

O valor da tag pode ter até 128 caracteres, mas não pode conter http:// ou https://. Além disso, não pode começar com aliyun ou acs:.

Parâmetros de resposta

Parameter

Type

Example

Description

RequestId String DC668356-BCB4-42FD-9BC3-FA2B2E04B634

ID da solicitação.

PageSize Integer 10

Quantidade de entradas por página.

PageNumber Integer 1

Número da página.

TotalCount Integer 1

Número total de entradas retornadas.

RouterTableList Array of RouterTableListType

Informações detalhadas sobre as tabelas de rotas.

RouterTableListType
VpcId String vpc-bp15zckdt37pq72****

ID da VPC à qual a tabela de rotas pertence.

CreationTime String 2021-08-22T10:40:25Z

Horário de criação da tabela de rotas.

Status String Available

Status da tabela de rotas. Valores válidos:

  • Pending
  • Available
  • Deleting
RouterId String vrt-bp1lhl0taikrteen8****

ID do roteador ao qual a tabela de rotas pertence.

AssociateType String VSwitch

Tipo de recurso de nuvem associado à tabela de rotas. Valores válidos:

  • VSwitch: um vSwitch
  • Gateway: um gateway IPv4
RouteTableId String vtb-bp145q7glnuzdvzu2****

ID da tabela de rotas.

OwnerId Long 253460731706911258

ID da conta Alibaba Cloud à qual a tabela de rotas pertence.

Description String This is Route Table.

Descrição da tabela de rotas.

RouteTableType String System

Tipo da tabela de rotas. Valores válidos:

  • Custom
  • System
ResourceGroupId String rg-acfmxazb4ph****

ID do grupo de recursos ao qual a tabela de rotas pertence.

RouterType String VRouter

Tipo do roteador ao qual a tabela de rotas pertence. Valores válidos:

  • VRouter
  • VBR
RouteTableName String doctest

Nome da tabela de rotas.

Tags Array of Tag

Tag adicionada à tabela de rotas.

Tag
Key String type

Chave da tag adicionada à tabela de rotas.

Value String ingress

Valor da tag adicionada à tabela de rotas.

VSwitchIds Array of String vsw-bp12mw1f8k3jgygk9****

ID do vSwitch.

GatewayIds Array of String ipv4gw-5tsnc6s4ogsedtp3k****

Informações detalhadas sobre o gateway IPv4.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?RouterType=VRouter
&RouterId=vrt-bp1lhl0taikrteen8****
&VpcId=vpc-bp15zckdt37pq72****
&RouteTableId=vtb-bp145q7glnuzdvzu2****
&RouteTableName=doctest
&PageNumber=1
&PageSize=10
&ResourceGroupId=rg-acfmxazb4ph****
&Action=DescribeRouteTableList
&RegionId=ap-southeast-6
&Tag=[{"Key":"FinanceDept","Value":"FinanceJoshua"}]
&Common request parameters

Exemplos de respostas de sucesso

Formato XML

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

<DescribeRouteTableListResponse>
    <RequestId>DC668356-BCB4-42FD-9BC3-FA2B2E04B634</RequestId>
    <PageSize>10</PageSize>
    <PageNumber>1</PageNumber>
    <TotalCount>1</TotalCount>
    <RouterTableList>
        <VpcId>vpc-bp15zckdt37pq72****</VpcId>
        <CreationTime>2021-08-22T10:40:25Z</CreationTime>
        <Status>Available</Status>
        <RouterId>vrt-bp1lhl0taikrteen8****</RouterId>
        <AssociateType>VSwitch</AssociateType>
        <RouteTableId>vtb-bp145q7glnuzdvzu2****</RouteTableId>
        <OwnerId>253460731706911260</OwnerId>
        <Description>This is Route Table.</Description>
        <RouteTableType>System</RouteTableType>
        <ResourceGroupId>rg-acfmxazb4ph****</ResourceGroupId>
        <RouterType>VRouter</RouterType>
        <RouteTableName>doctest</RouteTableName>
        <Tags>
            <Key>type</Key>
            <Value>ingress</Value>
        </Tags>
        <VSwitchIds>vsw-bp12mw1f8k3jgygk9****</VSwitchIds>
        <GatewayIds>ipv4gw-5tsnc6s4ogsedtp3k****</GatewayIds>
    </RouterTableList>
</DescribeRouteTableListResponse>

Formato JSON

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

{
  "RequestId" : "DC668356-BCB4-42FD-9BC3-FA2B2E04B634",
  "PageSize" : 10,
  "PageNumber" : 1,
  "TotalCount" : 1,
  "RouterTableList" : [ {
    "VpcId" : "vpc-bp15zckdt37pq72****",
    "CreationTime" : "2021-08-22T10:40:25Z",
    "Status" : "Available",
    "RouterId" : "vrt-bp1lhl0taikrteen8****",
    "AssociateType" : "VSwitch",
    "RouteTableId" : "vtb-bp145q7glnuzdvzu2****",
    "OwnerId" : 253460731706911260,
    "Description" : "This is Route Table.",
    "RouteTableType" : "System",
    "ResourceGroupId" : "rg-acfmxazb4ph****",
    "RouterType" : "VRouter",
    "RouteTableName" : "doctest",
    "Tags" : [ {
      "Key" : "type",
      "Value" : "ingress"
    } ],
    "VSwitchIds" : [ "vsw-bp12mw1f8k3jgygk9****" ],
    "GatewayIds" : [ "ipv4gw-5tsnc6s4ogsedtp3k****" ]
  } ]
}

Códigos de erro

HttpCode

Error code

Error message

Description

400

InvalidTagKey

The tag keys are not valid.

O índice da tag é inválido.

400

InvalidTagValue

The tag values are not valid.

O valor da tag é inválido.

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