Agregación de resultados de operaciones de paginación - - Centro de documentación de Alibaba Cloud

De forma predeterminada, las operaciones de paginación devuelven resultados solo en una página. Para obtener los resultados completos de una operación de paginación, utilice la opción --pager para agregar los resultados de paginación.

Campos y descripciones

En Alibaba Cloud CLI, puede utilizar la opción --pager para agregar los resultados de matriz de las operaciones de paginación. Esta opción contiene los siguientes campos:

Nota

Si los valores de campo que devuelve la operación difieren de los valores predeterminados, pueden producirse errores de análisis sintáctico. Se recomienda asignar manualmente los campos según la estructura de datos devuelta para garantizar la precisión y estabilidad de los datos.

Campo	Descripción	Valor predeterminado
PageNumber	Número de página por devolver.	`PageNumber`
PageSize	Número máximo de entradas por devolver en cada página.	`PageSize`
TotalCount	Número total de entradas.	`TotalCount`
NextToken	Token de paginación utilizado en la siguiente solicitud para recuperar una nueva página de resultados.	`NextToken`
path	Matriz de datos definida mediante JMESPath.	La ruta se identifica automáticamente. Por ejemplo, al llamar a la operación de API `DescribeInstances` de Elastic Compute Service (ECS), el valor predeterminado de `path` es `Instances.Instance`.

Escenario

Nota

Algunas operaciones admiten el parámetro maxResult, que especifica el número máximo de entradas por devolver en cada consulta. Si establece un valor menor al esperado, la frecuencia de solicitudes y el tiempo de procesamiento pueden aumentar considerablemente. Para optimizar la eficiencia de la consulta, se recomienda especificar un valor adecuado para maxResult cuando utilice la opción --pager en Alibaba Cloud CLI.

La operación DescribeInstances de ECS es una operación de paginación. De forma predeterminada, solo se devuelven los resultados de la primera página de la lista de instancias.
```
aliyun ecs DescribeInstances
```

Respuesta de ejemplo (parcial):

{
    "PageNumber": 1,
    "TotalCount": 4,
    "PageSize": 10,
    "RequestId": "6EA82E70-9750-4A97-A738-E021D8A57F07",
    "Instances": {
        "Instance": [
            {    
                "InstanceId": "i-m5edv0cqkr9hawls****",
                "ImageId": "win2012r2_64_dtc_9600_zh-cn_40G_alibase_20190318.vhd",
                "SerialNumber": "f06857e8-7f3c-443a-9f88-8e84eb51****",
                "Cpu": 1,
                "Memory": 2048,
                "DeviceAvailable": true,
                "SecurityGroupIds": {
                    "SecurityGroupId": [
                        "sg-bp1fgviwol82z8ap****"
                    ]
                }
            }
        ]
    }
}

Tras habilitar la agregación para una operación de paginación, obtendrá simultáneamente la información de las instancias de todas las páginas que devuelve la operación.
```
aliyun ecs DescribeInstances --pager PageNumber=PageNumber PageSize=PageSize TotalCount=TotalCount path=Instances.Instance
```
Si el valor de un campo coincide con el valor predeterminado, no es necesario especificar un valor explícito. Por ejemplo, el comando anterior se puede simplificar:
```
aliyun ecs DescribeInstances --pager
```

Al ejecutar el comando, se devuelven los resultados agregados. A continuación se muestra una parte del resultado.

Nota

Solo se devuelven los campos agregados. Si necesita filtrar campos específicos, configure la ruta de filtrado como la ruta agregada en JMESPath. Para obtener más información, consulte Extract parameters and tabulate output.

{
    "Instances": {
        "Instance": [
            {    
                "InstanceId": "i-m5edv0cqkr9hawls****",
                "ImageId": "win2012r2_64_dtc_9600_zh-cn_40G_alibase_20190318.vhd",
                "SerialNumber": "f06857e8-7f3c-443a-9f88-8e84eb51****",
                "Cpu": 1,
                "Memory": 2048,
                "DeviceAvailable": true,
                "SecurityGroupIds": {
                    "SecurityGroupId": [
                        "sg-bp1fgviwol82z8ap****"
                    ]
                }
            }
        ]
    }
}