DescribeRouteTables - Virtual Private Cloud: Central de Documentação do Alibaba Cloud

Consulta tabelas de rotas.

Nota

Esta API foi descontinuada. Recomendamos migrar para Vpc(2016-04-28) - DescribeRouteTableList para funcionalidade aprimorada e suporte contínuo. Embora a API descontinuada permaneça temporariamente acessível, nenhuma atualização ou correção de bugs será fornecida.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

vpc:DescribeRouteTables

list

*RouteTable.

acs:vpc:{#regionId}:{#accountId}:routetable/{#RouteTableId}

vpc:VBR
vpc:VRouter

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Não	O ID da região da VPC à qual a tabela de rotas pertence. Você pode chamar a operação DescribeRegions para consultar o ID da região.	ap-southeast-6
VRouterId	string	Não	O ID do vRouter a ser consultado. Nota Você deve especificar pelo menos um dos seguintes parâmetros: VRouterId, RouteTableId, RouterId e RouteTableName. Você não pode especificar VRouterId e RouterId simultaneamente.	vrt-bp1lhl0taikrteen****
RouteTableId	string	Não	O ID da tabela de rotas a ser consultada. Nota Você deve especificar pelo menos um dos seguintes parâmetros: VRouterId, RouteTableId, RouterId e RouteTableName. Você não pode especificar VRouterId e RouterId simultaneamente.	vtb-bp145q7glnuzdvzu2****
RouterType	string	Não	O tipo do roteador ao qual a tabela de rotas pertence. Valores válidos: VRouter (padrão): vRouter. VBR: Virtual Border Router.	VRouter
RouterId	string	Não	O ID do roteador ao qual a tabela de rotas pertence. Nota Você deve especificar pelo menos um dos seguintes parâmetros: VRouterId, RouteTableId, RouterId e RouteTableName. Você não pode especificar VRouterId e RouterId simultaneamente.	vrt-bp1lhl0taikrteen8****
Type	string	Não	O tipo da entrada de rota a ser consultada. Valores válidos: Custom: rota personalizada. System: rota do sistema. BGP: rota BGP. CEN: rota da Cloud Enterprise Network (CEN). ECR: rota do Express Connect Router (ECR).	Custom
RouteTableName	string	Não	O nome da tabela de rotas a ser consultada. O nome deve ter de 2 a 128 caracteres e deve começar com uma letra ou caractere chinês. Pode conter dígitos, pontos (.), sublinhados (_) e hifens (-). Nota Você deve especificar pelo menos um dos seguintes parâmetros: VRouterId, RouteTableId, RouterId e RouteTableName. Você não pode especificar VRouterId e RouterId simultaneamente.	doctest
ResourceGroupId	string	Não	O ID do grupo de recursos ao qual a tabela de rotas pertence.	rg-acfmxazb4ph****
PageNumber	integer	Não	O número da página. Valor padrão: 1.	1
PageSize	integer	Não	O número de entradas por página para paginação. Valor máximo: 50. Valor padrão: 10.	10

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	O número de entradas por página.
PageSize	integer	O número de entradas por página.	10
RequestId	string	O ID da solicitação.	DC668356-BCB4-42FD-9BC3-FA2B2E04B634
PageNumber	integer	O número da página atual.	1
TotalCount	integer	O número total de entradas retornadas.	1
RouteTables	object
RouteTable	array<object>	Os detalhes das tabelas de rotas.
	array<object>	A hora em que a tabela de rotas foi criada.
CreationTime	string	A hora em que a tabela de rotas foi criada. A hora é exibida em UTC no formato `YYYY-MM-DDThh:mm:ssZ`.	2022-08-22T10:40:25Z
Status	string	O status da tabela de rotas. Valores válidos: Pending: sendo configurada. Available: ativa.	Available
VRouterId	string	O ID do vRouter.	vrt-bp1lhl0taikrteen****
RouteTableType	string	O tipo da tabela de rotas. Valores válidos: Custom: tabela de rotas personalizada. System: tabela de rotas do sistema.	Custom
ResourceGroupId	string	O ID do grupo de recursos ao qual a tabela de rotas pertence.	rg-acfmxazb4ph****
RouteTableId	string	O ID da tabela de rotas.	vtb-bp145q7glnuzdvzu2****
RouteEntrys	object
RouteEntry	array<object>	As informações da rota.
	array<object>	As informações da rota.
Type	string	O tipo de destino da rota. Valores válidos: Custom: rota personalizada. System: rota do sistema. BGP: rota BGP. CEN: rota do Cloud Enterprise Network (CEN). ECR: rota do Express Connect Router (ECR).	Custom
Status	string	O status da rota. Valores válidos: Pending: sendo configurada. Available: ativa. Modifying: sendo modificada.	Available
NextHopType	string	O tipo do próximo salto. Valores válidos: Instance (padrão): instância ECS. HaVip: endereço IP virtual de alta disponibilidade. VpnGateway: VPN gateway. NatGateway: NAT gateway. NetworkInterface: controlador de interface de rede elástica (NIC) secundário. RouterInterface: interface do vRouter. IPv6Gateway: gateway IPv6. Attachment: transit router. Ipv4Gateway: gateway IPv4. GatewayEndpoint: gateway endpoint. CenBasic: CEN que não suporta transit routers. Ecr: Express Connect Router (ECR).	Instance
RouteEntryName	string	O nome da rota. O nome deve ter de 2 a 128 caracteres e deve começar com uma letra ou um caractere chinês. Pode conter dígitos, pontos (.), underscores (_) e hifens (-).	name
RouteEntryId	string	O ID da rota.	rte-bp1mnnr2al0naomnp****
InstanceId	string	O ID da instância associada ao próximo salto.	vpc-bp1t36rn9l53iwbsf****
RouteTableId	string	O ID da tabela de rotas.	vtb-bp15w5q90d2rk3bww****
Description	string	A descrição da rota. A descrição deve ter de 2 a 256 caracteres e deve começar com uma letra ou um caractere chinês. Não pode começar com `http://` ou `https://`.	RouteEntryDescription
DestinationCidrBlock	string	O bloco CIDR de destino da rota. Blocos CIDR de destino IPv4 e IPv6 são suportados. Os seguintes requisitos devem ser atendidos: O bloco CIDR de destino não pode apontar para ou estar contido em 100.64.0.0/10. Os blocos CIDR de destino de diferentes rotas na mesma tabela de rotas devem ser exclusivos.	192.168.2.0/24
NextHops	object
NextHop	array<object>	As informações do próximo salto.
	object	As informações do próximo salto.
NextHopId	string	O ID da instância do próximo salto.	vpn-bp10zyaph5cc8b7c7****
Weight	integer	O peso da rota.	100
NextHopType	string	O tipo do próximo salto. Valores válidos: Instance: instância ECS. HaVip: endereço IP virtual de alta disponibilidade. VpnGateway: VPN gateway. NatGateway: NAT gateway. NetworkInterface: controlador de interface de rede elástica (NIC) secundário. RouterInterface: interface do vRouter. IPv6Gateway: gateway IPv6. Attachment: transit router. Ipv4Gateway: gateway IPv4. GatewayEndpoint: gateway endpoint. CenBasic: CEN que não suporta transit routers. Ecr: Express Connect Router (ECR).	Instance
Enabled	integer	Indica se a rota está disponível. Valores válidos: 0: indisponível. 1: disponível.	1
VSwitchIds	object
VSwitchId	array	O ID do vSwitch.
	string	O ID do vSwitch.	vsw-bp12mw1f8k3jgygk9****

Exemplos

Resposta de sucesso

JSON formato

{
  "PageSize": 10,
  "RequestId": "DC668356-BCB4-42FD-9BC3-FA2B2E04B634",
  "PageNumber": 1,
  "TotalCount": 1,
  "RouteTables": {
    "RouteTable": [
      {
        "CreationTime": "2022-08-22T10:40:25Z",
        "Status": "Available",
        "VRouterId": "vrt-bp1lhl0taikrteen****",
        "RouteTableType": "Custom",
        "ResourceGroupId": "rg-acfmxazb4ph****",
        "RouteTableId": "vtb-bp145q7glnuzdvzu2****",
        "RouteEntrys": {
          "RouteEntry": [
            {
              "Type": "Custom",
              "Status": "Available",
              "NextHopType": "Instance",
              "RouteEntryName": "name",
              "RouteEntryId": "rte-bp1mnnr2al0naomnp****",
              "InstanceId": "vpc-bp1t36rn9l53iwbsf****",
              "RouteTableId": "vtb-bp15w5q90d2rk3bww****",
              "Description": "RouteEntryDescription",
              "DestinationCidrBlock": "192.168.2.0/24",
              "NextHops": {
                "NextHop": [
                  {
                    "NextHopId": "vpn-bp10zyaph5cc8b7c7****",
                    "Weight": 100,
                    "NextHopType": "Instance",
                    "Enabled": 1
                  }
                ]
              }
            }
          ]
        },
        "VSwitchIds": {
          "VSwitchId": [
            "vsw-bp12mw1f8k3jgygk9****"
          ]
        }
      }
    ]
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidVRouterId.NotFound	Specified virtual router does not exist.
400	OperationFailed.DescribeCenRoute	An error occurred while querying the CEN route entry.	Ocorreu um erro ao consultar as rotas do CEN.
400	OperationFailed.VRouterNotExist	Operation failed because the VRouter does not exist.	A operação falhou porque o vRouter não existe.
400	IllegalParam.Type	The parameter of Type is illegal.	O parâmetro Type é inválido.
400	OperationFailed.InvalidRouterType	The operation is failed because of %s.	O tipo de roteador é inválido.
400	InvalidParam.RouterInstanceOrRouterId	The parameters routerInstanceId and routerId are mutually exclusive. Please use either routerInstanceId alone, or routerType with routerId.	A solicitação contém parâmetros conflitantes. Você deve fornecer apenas routerInstanceId, ou fornecer routerType e routerId. Remova a combinação de parâmetros conflitante da solicitação.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.