DescribeRouteEntryList - - Centro de documentación de Alibaba Cloud

Consulta rutas en una tabla de rutas.

Notas de uso

Antes de llamar a la operación DeleteRouteEntry para eliminar una ruta, puede llamar a esta operación para consultar el siguiente salto de la ruta que desea eliminar.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos que llame a esta operación en OpenAPI Explorer. OpenAPI Explorer genera dinámicamente el código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
RegionId	String	Sí	cn-hangzhou	El ID de región de la tabla de rutas. Puede llamar a la operación DescribeRegions para consultar la lista de regiones más reciente.
RouteTableId	String	Sí	vtb-bp1r9pvl4xen8s9ju****	El ID de la tabla de rutas.
RouteEntryId	String	No	rte-bp1mnnr2al0naomnp****	El ID de la ruta que desea consultar.
DestinationCidrBlock	String	No	192.168.2.0/24	El bloque CIDR de destino de la ruta. Se admiten bloques CIDR IPv4 e IPv6.
RouteEntryName	String	No	abc	El nombre de la ruta. El nombre debe tener entre 1 y 128 caracteres de longitud y no puede comenzar con `http://` o `https://`.
IpVersion	String	No	ipv4	La versión de IP. Valores válidos: ipv4 ipv6
RouteEntryType	String	No	System	El tipo de ruta. Valores válidos: Custom: una ruta personalizada System: una ruta del sistema BGP: una ruta BGP CEN: una ruta de Cloud Enterprise Network (CEN)
NextHopId	String	No	vpn-bp10zyaph5cc8b7c7****	El ID del siguiente salto.
NextHopType	String	No	Instance	El tipo de siguiente salto. Valores válidos: Instance (predeterminado): una instancia de Elastic Compute Service (ECS) HaVip: una dirección IP virtual de alta disponibilidad (HAVIP) VpnGateway: una puerta de enlace VPN NatGateway: una puerta de enlace NAT NetworkInterface: una interfaz de red elástica secundaria (ENI) RouterInterface: una interfaz de router IPv6Gateway: una puerta de enlace IPv6 Attachment: un transit router
MaxResult	Integer	No.	10	El número de entradas que se devolverán en cada página. Valores válidos: de 1 a 100. Valor predeterminado: 10.
NextToken	String	No	FFmyTO70tTpLG6I3FmYAXGKPd****	El token que se utiliza para la siguiente consulta. Valores válidos: Si esta es su primera consulta y no se enviarán consultas posteriores, ignore este parámetro. Si se va a enviar una consulta posterior, establezca el parámetro con el valor de NextToken devuelto en la última llamada.
Action	String	Sí	DescribeRouteEntryList	La operación que desea ejecutar. Establezca el valor en DescribeRouteEntryList.
ServiceType	String	No	TR	Especifica si la ruta está alojada. Si el parámetro está vacío, la ruta no está alojada. Si establece el valor en TR, la ruta está alojada por un transit router.
DestCidrBlockList.N	String	No	192.168.0.0/24	Los bloques CIDR de destino de la ruta. Puede especificar hasta 20 bloques CIDR de destino.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
NextToken	String	FFmyTO70tTpLG6I3FmYAXGKPd****	El token que se utiliza para la siguiente consulta. Valores válidos: Si NextToken está vacío, indica que no se enviará ninguna consulta posterior. Si se devuelve un valor de NextToken, dicho valor es el token que se utilizará para la consulta subsiguiente.
RequestId	String	14A07460-EBE7-47CA-9757-12CC4761D47A	El ID de la solicitud.
RouteEntrys	Array of RouteEntry		La información sobre las rutas.
RouteEntry
Status	String	Available	El estado de la ruta. Valores válidos: Pending: La ruta se está configurando. Available: La ruta está disponible. Modifying: La ruta se está modificando.
Type	String	Custom	El tipo de ruta. Valores válidos: Custom: una ruta personalizada System: una ruta del sistema BGP: una ruta BGP CEN: una ruta CEN
IpVersion	String	ipv4	La versión de IP. Valores válidos: ipv4 ipv6
Description	String	RouteEntryDescription	La descripción de la ruta.
RouteEntryName	String	aaa	El nombre de la ruta.
DestinationCidrBlock	String	192.168.2.0/24	Los bloques CIDR de destino de la ruta.
RouteEntryId	String	rte-bp1mnnr2al0naomnp****	El ID de la ruta.
RouteTableId	String	vtb-bp15w5q90d2rk3bww****	El ID de la tabla de rutas.
GmtModified	String	2022-05-09T03:00:07Z	La hora en que se modificó la ruta. La hora se muestra en formato `YYYY-MM-DDThh:mm:ssZ` en UTC.
NextHops	Array of NextHop		La información sobre los siguientes saltos.
NextHop
NextHopRegionId	String	cn-hangzhou	El ID de región del siguiente salto. Nota Este parámetro se devuelve si el tipo de siguiente salto está establecido en RouterInterface.
Weight	Integer	100	El peso de la ruta. Nota Este parámetro se devuelve si el tipo de siguiente salto está establecido en RouterInterface.
NextHopId	String	vpn-bp10zyaph5cc8b7c7****	El ID del siguiente salto.
Enabled	Integer	1	Indica si la ruta está disponible. Valores válidos: 0: no disponible 1: disponible Nota Este parámetro se devuelve si el tipo de siguiente salto está establecido en RouterInterface.
NextHopType	String	Instance	El tipo de siguiente salto. Valores válidos: Instance: una instancia ECS HaVip: una HAVIP VpnGateway: una puerta de enlace VPN NatGateway: una puerta de enlace NAT NetworkInterface: una ENI secundaria RouterInterface: una interfaz de router IPv6Gateway: una puerta de enlace IPv6 Attachment: un transit router
NextHopRelatedInfo	Object		La información sobre el siguiente salto.
InstanceId	String	vpc-bp1t36rn9l53iwbsf****	El ID de la instancia asociada con el siguiente salto.
InstanceType	String	VPC	El tipo de instancia asociada con el siguiente salto. Valores válidos: VPC: una nube privada virtual (VPC) VBR: una VBR PCONN: un circuito Express Connect
RegionId	String	ch-hangzhou	El ID de región de la instancia asociada con el siguiente salto.
ServiceType	String	TR	Indica si la ruta está alojada. Si el parámetro está vacío, la ruta no está alojada. Si el valor está establecido en TR, la ruta está alojada por un transit router.

Ejemplos

Solicitudes de ejemplo

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

Respuestas exitosas de ejemplo

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 error

HttpCode	Código de error	Mensaje de error	Descripción
400	OperationFailed.QueryCenEntry	Operation is denied because getting CEN route entry has failed.	El mensaje de error devuelto porque el sistema no pudo consultar las rutas CEN.
400	OperationDenied.UseGatewayRouteEntryQueryInterface	Use listGatewayRouteTableEntries to describe gateway route entries.	Para consultar las rutas de una tabla de rutas de puerta de enlace, llame a la operación listGatewayRouteTableEntries.

Para obtener una lista de códigos de error, visite el Centro de errores de API.