DescribeRouteTableList - - Centro de documentación de Alibaba Cloud

Consulta tablas de rutas.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos llamar 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
RouterType	String	No	VRouter	Tipo de router al que pertenece la tabla de rutas. Valor válido: VRouter (predeterminado) VBR
RouterId	String	No	vrt-bp1lhl0taikrteen8****	ID del router al que pertenece la tabla de rutas.
VpcId	String	No	vpc-bp15zckdt37pq72****	ID de la virtual private cloud (VPC) a la que pertenece la tabla de rutas. Si especifica este parámetro, el valor del parámetro RouterType se establece automáticamente en VRouter.
RouteTableId	String	No	vtb-bp145q7glnuzdvzu2****	ID de la tabla de rutas que desea consultar.
RouteTableName	String	No	doctest	Nombre de la tabla de rutas que desea consultar.
PageNumber	Integer	No	1	Número de página. Valor predeterminado: 1.
PageSize	Integer	No	10	Número de entradas por página. Valor máximo: 50. Valor predeterminado: 10.
ResourceGroupId	String	No	rg-acfmxazb4ph****	ID del resource group al que pertenece la tabla de rutas por consultar.
Action	String	Sí	DescribeRouteTableList	Operación que desea ejecutar. Establezca el valor en DescribeRouteTableList.
RegionId	String	Sí	ap-southeast-6	ID de región de la VPC a la que pertenece la tabla de rutas. Llame a la operación DescribeRegions para consultar la lista de regiones más reciente.
Tag.N.Key	String	No	FinanceDept	Clave de la etiqueta N que se agregará al recurso. Puede especificar hasta 20 claves de etiqueta. La clave de la etiqueta no puede ser una cadena vacía. La clave de la etiqueta puede tener una longitud máxima de 128 caracteres. No debe comenzar con `aliyun` ni con `acs:`, y no puede contener `http://` o `https://`.
Tag.N.Value	String	No	FinanceJoshua	Valor de la etiqueta N que se agregará al recurso. Puede especificar hasta 20 valores de etiqueta. El valor de la etiqueta puede ser una cadena vacía. El valor de la etiqueta admite hasta 128 caracteres de longitud, pero no puede contener `http://` ni `https://`. Tampoco debe comenzar con `aliyun` o `acs:`.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
RequestId	String	DC668356-BCB4-42FD-9BC3-FA2B2E04B634	ID de la solicitud.
PageSize	Integer	10	Número de entradas por página.
PageNumber	Integer	1	Número de página.
TotalCount	Integer	1	Número total de entradas devueltas.
RouterTableList	Array of RouterTableListType		Información detallada sobre las tablas de rutas.
RouterTableListType
VpcId	String	vpc-bp15zckdt37pq72****	ID de la VPC a la que pertenece la tabla de rutas.
CreationTime	String	2021-08-22T10:40:25Z	Hora en que se creó la tabla de rutas.
Status	String	Available	Estado de la tabla de rutas. Valor válido: Pending Available Deleting
RouterId	String	vrt-bp1lhl0taikrteen8****	ID del router al que pertenece la tabla de rutas.
AssociateType	String	VSwitch	Tipo de recurso en la nube asociado a la tabla de rutas. Valores válidos: VSwitch: un vSwitch Gateway: un gateway IPv4
RouteTableId	String	vtb-bp145q7glnuzdvzu2****	ID de la tabla de rutas.
OwnerId	Long	253460731706911258	ID de la cuenta de Alibaba Cloud propietaria de la tabla de rutas.
Description	String	This is Route Table.	Descripción de la tabla de rutas.
RouteTableType	String	System	Tipo de la tabla de rutas. Valor válido: Custom System
ResourceGroupId	String	rg-acfmxazb4ph****	ID del resource group al que pertenece la tabla de rutas.
RouterType	String	VRouter	Tipo de router al que pertenece la tabla de rutas. Valor válido: VRouter VBR
RouteTableName	String	doctest	Nombre de la tabla de rutas.
Tags	Array of Tag		Etiqueta asignada a la tabla de rutas.
Tag
Key	String	type	Clave de la etiqueta asignada a la tabla de rutas.
Value	String	ingress	Valor de la etiqueta asignada a la tabla de rutas.
VSwitchIds	Array of String	vsw-bp12mw1f8k3jgygk9****	ID del vSwitch.
GatewayIds	Array of String	ipv4gw-5tsnc6s4ogsedtp3k****	Información detallada sobre el gateway IPv4.

Ejemplos

Solicitudes de ejemplo

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

Respuestas exitosas de ejemplo

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 error

HttpCode	Código de error	Mensaje de error	Descripción
400	InvalidTagKey	The tag keys are not valid.	El índice de la etiqueta no es válido.
400	InvalidTagValue	The tag values are not valid.	El valor de la etiqueta no es válido.

Para obtener una lista de códigos de error, consulte Códigos de error del servicio.