DescribeRouteEntryList - : Central de Documentação do Alibaba Cloud

Observações de uso

Antes de chamar a operação DeleteRouteEntry para excluir uma rota, chame esta operação para consultar o próximo salto da rota a ser excluída.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos usar esta ferramenta para chamar a operação. O OpenAPI Explorer também gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
RegionId	String	Sim	cn-hangzhou	ID da região da tabela de rotas. Chame a operação DescribeRegions para obter a lista de regiões mais recente.
RouteTableId	String	Sim	vtb-bp1r9pvl4xen8s9ju****	ID da tabela de rotas.
RouteEntryId	String	Não	rte-bp1mnnr2al0naomnp****	ID da rota a ser consultada.
DestinationCidrBlock	String	Não	192.168.2.0/24	Bloco CIDR de destino da rota. Há suporte para blocos CIDR IPv4 e IPv6.
RouteEntryName	String	Não	abc	Nome da rota. O nome deve ter de 1 a 128 caracteres e não pode começar com `http://` ou `https://`.
IpVersion	String	Não	ipv4	Versão do IP. Valores válidos: ipv4 ipv6
RouteEntryType	String	Não	System	Tipo da rota. Valores válidos: Custom System BGP CEN
NextHopId	String	Não	vpn-bp10zyaph5cc8b7c7****	ID do próximo salto.
NextHopType	String	Não	Instance	Tipo do próximo salto. Valores válidos: Instance (padrão): instância do Elastic Compute Service (ECS) HaVip: endereço IP virtual de alta disponibilidade (HAVIP) VpnGateway: gateway VPN NatGateway: gateway NAT NetworkInterface: interface de rede elástica (ENI) secundária RouterInterface: interface de roteador IPv6Gateway: gateway IPv6 Attachment: roteador de trânsito
MaxResult	Integer	Não	10	Número de entradas a retornar por página. Valores válidos: 1 a 100. Valor padrão: 10.
NextToken	String	Não	FFmyTO70tTpLG6I3FmYAXGKPd****	Token de paginação usado na próxima solicitação para recuperar uma nova página de resultados. Valores válidos: Não é necessário especificar este parâmetro na primeira solicitação. Para enviar uma nova consulta, defina o parâmetro com o valor de NextToken retornado na última chamada.
Action	String	Sim	DescribeRouteEntryList	Operação a ser executada. Defina o valor como DescribeRouteEntryList.
ServiceType	String	Não	TR	Indica se a rota é hospedada. Se o parâmetro estiver vazio, a rota não é hospedada. Se definido como TR, a rota será hospedada por um roteador de trânsito.
DestCidrBlockList.N	String	Não	192.168.0.0/24	Blocos CIDR de destino da rota. É possível especificar até 20 blocos CIDR de destino.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
NextToken	String	FFmyTO70tTpLG6I3FmYAXGKPd****	Valor retornado de NextToken, que funciona como token de paginação para recuperar a próxima página de resultados. Valores válidos: Se NextToken estiver vazio, não há próxima página. Se NextToken não estiver vazio, use esse valor na próxima solicitação para obter novos resultados.
RequestId	String	14A07460-EBE7-47CA-9757-12CC4761D47A	ID da solicitação.
RouteEntrys	Array of RouteEntry		Informações sobre a rota.
RouteEntry
Status	String	Available	Status da rota. Valores válidos: Pending Available Modifying
Type	String	System	Tipo da rota. Valores válidos: Custom System BGP CEN
IpVersion	String	ipv4	Versão do IP. Valores válidos: ipv4 ipv6
Description	String	RouteEntryDescription	Descrição da rota.
RouteEntryName	String	aaa	Nome da rota.
DestinationCidrBlock	String	192.168.2.0/24	Bloco CIDR de destino da rota.
RouteEntryId	String	rte-bp1mnnr2al0naomnp****	ID da rota.
RouteTableId	String	vtb-bp15w5q90d2rk3bww****	ID da tabela de rotas.
GmtModified	String	2022-05-09T03:00:07Z	Horário da última modificação da rota, exibido no formato `YYYY-MM-DDThh:mm:ssZ` (UTC).
NextHops	Array of NextHop		Informações sobre o próximo salto.
NextHop
NextHopRegionId	String	cn-hangzhou	ID da região do próximo salto. Nota Este parâmetro é retornado apenas se o tipo de próximo salto for RouterInterface.
Weight	Integer	100	Peso da rota. Nota Este parâmetro é retornado apenas se o tipo de próximo salto for RouterInterface.
NextHopId	String	vpn-bp10zyaph5cc8b7c7****	ID do próximo salto.
Enabled	Integer	1	Indica se a rota está disponível. Valores válidos: 0: indisponível 1: disponível Nota Este parâmetro é retornado apenas se o tipo de próximo salto for RouterInterface.
NextHopType	String	Instance	Tipo do próximo salto. Valores válidos: Instance: instância ECS HaVip: HAVIP VpnGateway: gateway VPN NatGateway: gateway NAT NetworkInterface: ENI secundária RouterInterface: interface de roteador IPv6Gateway: gateway IPv6 Attachment: roteador de trânsito
NextHopRelatedInfo	Object		Informações relacionadas ao próximo salto.
InstanceId	String	vpc-bp1t36rn9l53iwbsf****	ID da instância associada ao próximo salto.
InstanceType	String	VPC	Tipo da instância associada ao próximo salto. Valores válidos: VPC: VPC VBR: VBR PCONN: circuito Express Connect
RegionId	String	ch-hangzhou	ID da região da instância associada ao próximo salto.
ServiceType	String	TR	Indica se a rota é hospedada. Se o parâmetro estiver vazio, a rota não é hospedada. Se TR for retornado, a rota é hospedada por um roteador de trânsito.

Exemplos

Solicitações de exemplo

http(s)://[Endpoint]/?RegionId=cn-hangzhou
&RouteTableId=vtb-bp1r9pvl4xen8s9ju****
&RouteEntryId=rte-bp1mnnr2al0naomnp****
&DestinationCidrBlock=192.168.2.0/24
&RouteEntryName=abc
&IpVersion=ipv4
&RouteEntryType=System
&NextHopId=vpn-bp10zyaph5cc8b7c7****
&NextHopType=Instance
&MaxResult=10
&NextToken=FFmyTO70tTpLG6I3FmYAXGKPd****
&Action=DescribeRouteEntryList
&ServiceType=TR
&DestCidrBlockList=["192.168.0.0/24"]
&Common request parameters

Respostas de sucesso de exemplo

Formato XML

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

<DescribeRouteEntryListResponse>
    <NextToken>FFmyTO70tTpLG6I3FmYAXGKPd****</NextToken>
    <RequestId>14A07460-EBE7-47CA-9757-12CC4761D47A</RequestId>
    <RouteEntrys>
        <Status>Available</Status>
        <Type>Custom</Type>
        <IpVersion>ipv4</IpVersion>
        <Description>RouteEntryDescription</Description>
        <RouteEntryName>aaa</RouteEntryName>
        <DestinationCidrBlock>192.168.2.0/24</DestinationCidrBlock>
        <RouteEntryId>rte-bp1mnnr2al0naomnp****</RouteEntryId>
        <RouteTableId>vtb-bp15w5q90d2rk3bww****</RouteTableId>
        <GmtModified>2022-05-09T03:00:07Z</GmtModified>
        <NextHops>
            <NextHopRegionId>cn-hangzhou</NextHopRegionId>
            <Weight>100</Weight>
            <NextHopId>vpn-bp10zyaph5cc8b7c7****</NextHopId>
            <Enabled>1</Enabled>
            <NextHopType>Instance</NextHopType>
            <NextHopRelatedInfo>
                <InstanceId>vpc-bp1t36rn9l53iwbsf****</InstanceId>
                <InstanceType>VPC</InstanceType>
                <RegionId>ch-hangzhou</RegionId>
            </NextHopRelatedInfo>
        </NextHops>
        <ServiceType>TR</ServiceType>
    </RouteEntrys>
</DescribeRouteEntryListResponse>

Formato JSON

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

{
  "NextToken" : "FFmyTO70tTpLG6I3FmYAXGKPd****",
  "RequestId" : "14A07460-EBE7-47CA-9757-12CC4761D47A",
  "RouteEntrys" : [ {
    "Status" : "Available",
    "Type" : "Custom",
    "IpVersion" : "ipv4",
    "Description" : "RouteEntryDescription",
    "RouteEntryName" : "aaa",
    "DestinationCidrBlock" : "192.168.2.0/24",
    "RouteEntryId" : "rte-bp1mnnr2al0naomnp****",
    "RouteTableId" : "vtb-bp15w5q90d2rk3bww****",
    "GmtModified" : "2022-05-09T03:00:07Z",
    "NextHops" : [ {
      "NextHopRegionId" : "cn-hangzhou",
      "Weight" : 100,
      "NextHopId" : "vpn-bp10zyaph5cc8b7c7****",
      "Enabled" : 1,
      "NextHopType" : "Instance",
      "NextHopRelatedInfo" : {
        "InstanceId" : "vpc-bp1t36rn9l53iwbsf****",
        "InstanceType" : "VPC",
        "RegionId" : "ch-hangzhou"
      }
    } ],
    "ServiceType" : "TR"
  } ]
}

Códigos de erro

HttpCode	Código de erro	Mensagem de erro	Descrição
400	OperationFailed.QueryCenEntry	Operation is denied because getting CEN route entry has failed.	Falha ao consultar as rotas do CEN.
400	OperationDenied.UseGatewayRouteEntryQueryInterface	Use listGatewayRouteTableEntries to describe gateway route entries.	Para consultar as rotas de uma tabela de rotas de gateway, chame a operação listGatewayRouteTableEntries.

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