自动分页
更新时间:2026-06-10
对于支持分页的 API,BCE CLI 提供 --pager Flag,自动循环请求所有页面并合并结果,无需手动处理 marker。
基本用法
Bash
1bce vpc QueryVpcList --pager
BCE CLI 自动检测响应中的 nextMarker 字段并循环请求,直到获取全部数据。
限制返回总条数
使用 --total-count 限制最多返回的条目数,--total-count 必须与 --pager 一起使用:
Bash
1bce vpc QueryVpcList --pager --total-count 50
当达到限制时,响应中会包含 nextMarker 字段,可将其值作为下次请求的 --marker 参数继续翻页:
Bash
1bce vpc QueryVpcList --pager --total-count 50 --marker "xxx"
指定每页大小
通过 API 原生的分页参数(如 --maxKeys)控制每次请求的页面大小:
Bash
1bce vpc QueryVpcList --pager --maxKeys 100
与结果过滤组合
Bash
1bce vpc QueryVpcList --pager \
2 --query "vpcs[].name" \
3 --output text
评价此篇文章
