- Paging controls the number of output shown on the CLI prompt, when we run the cli commands.
- The default page size is 100
- If you run a command which has 300 object, CL will make three different API calls but the output will show all in same cmd window as a single API. You may need to pass the next token value depending upon the command you run.
- In certain cases if the object exceeds 1000 limit, we may get time out error.
- To fix this error we will use the flag –page-size and provide the number less than the limit.
- Still the CLI will fetch all records but with more number of API calls fetching records in smaller number.
- Use –max-item flag to limit the CLI output
CLI paging commands
As shown below example, we are using paging to fetch the s3 bucket list.
aws s3api list-objects --bucket <YOUR_BUCKET_NAME>
aws s3api list-objects --bucket <YOUR_BUCKET_NAME> --page-size 5
aws s3api list-objects --bucket <YOUR_BUCKET_NAME> --max-items 1