Use o Alibaba Cloud CLI para agregar os resultados de operações de paginação - : Central de Documentação do Alibaba Cloud

Por padrão, as operações de paginação retornam o resultado apenas em uma única página. Para obter os resultados completos de uma operação de paginação, use a opção --pager para agregar os resultados paginados.

Campos e descrições

No Alibaba Cloud CLI, a opção --pager permite agregar os resultados em array das operações de paginação. Essa opção contém os seguintes campos:

Nota

Se os valores dos campos retornados pela operação forem diferentes dos valores padrão, poderão ocorrer erros de análise. Recomendamos mapear manualmente os campos com base na estrutura de dados retornada para garantir a precisão e a estabilidade dos dados.

Campo	Descrição	Valor padrão
PageNumber	Número da página a ser retornada.	`PageNumber`
PageSize	Quantidade máxima de entradas a serem retornadas em cada página.	`PageSize`
TotalCount	Total de entradas existentes.	`TotalCount`
NextToken	Token de paginação utilizado na próxima solicitação para recuperar uma nova página de resultados.	`NextToken`
path	Array JMESPath dos dados.	O caminho é identificado automaticamente. Por exemplo, ao chamar a operação de API `DescribeInstances` do Elastic Compute Service (ECS), o valor padrão de `path` é `Instances.Instance`.

Cenário

Nota

Algumas operações aceitam o parâmetro maxResult, que define a quantidade máxima de entradas retornadas por consulta. Caso você especifique um valor menor que o esperado, a frequência de solicitações e o tempo de processamento podem aumentar significativamente. Para otimizar a eficiência da consulta, recomendamos definir um valor adequado para maxResult ao utilizar a opção --pager no Alibaba Cloud CLI.

A operação DescribeInstances do ECS é uma operação de paginação. Por padrão, ela retorna apenas os resultados da primeira página da lista de instâncias.
```
aliyun ecs DescribeInstances
```

Exemplo de resposta (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****"
                    ]
                }
            }
        ]
    }
}

Ao ativar a agregação para uma operação de paginação, você obtém as informações das instâncias de todas as páginas retornadas pela operação de uma só vez.
```
aliyun ecs DescribeInstances --pager PageNumber=PageNumber PageSize=PageSize TotalCount=TotalCount path=Instances.Instance
```
Quando o valor de um campo for igual ao valor padrão, não é necessário especificá-lo explicitamente. Por exemplo, o comando anterior pode ser simplificado:
```
aliyun ecs DescribeInstances --pager
```

Após executar o comando, os resultados agregados são retornados. A saída abaixo mostra parte do resultado.

Nota

Apenas os campos agregados são retornados. Se precisar filtrar campos específicos, defina o caminho de filtragem como o caminho agregado em JMESPath. Para mais informações, consulte Extrair parâmetros e tabular a saída.

{
    "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****"
                    ]
                }
            }
        ]
    }
}