{"componentChunkName":"component---src-templates-acg-portal-new-template-tsx","path":"/7mq6d16av","result":{"data":{"markdownRemark":{"html":"

对于支持分页的 API，BCE CLI 提供 --pager Flag，自动循环请求所有页面并合并结果，无需手动处理 marker。

\n

基本用法

\n\n
\n
\n
\n Bash\n \n
\n
\n 
1bce vpc QueryVpcList --pager
\n
\n
\n
\n \n

BCE CLI 自动检测响应中的 nextMarker 字段并循环请求，直到获取全部数据。

\n

限制返回总条数

\n

使用 --total-count 限制最多返回的条目数，--total-count 必须与 --pager 一起使用：

\n\n
\n
\n
\n Bash\n \n
\n
\n 
1bce vpc QueryVpcList --pager --total-count 50
\n
\n
\n
\n \n

当达到限制时，响应中会包含 nextMarker 字段，可将其值作为下次请求的 --marker 参数继续翻页：

\n\n
\n
\n
\n Bash\n \n
\n
\n 
1bce vpc QueryVpcList --pager --total-count 50 --marker \"xxx\"
\n
\n
\n
\n \n

指定每页大小

\n

通过 API 原生的分页参数（如 --maxKeys）控制每次请求的页面大小：

\n\n
\n
\n
\n Bash\n \n
\n
\n 
1bce vpc QueryVpcList --pager --maxKeys 100
\n
\n
\n
\n \n

与结果过滤组合

\n\n
\n
\n
\n Bash\n \n
\n
\n 
1bce vpc QueryVpcList --pager \\\n2  --query \"vpcs[].name\" \\\n3  --output text
\n
\n
\n
\n ","fields":{"slug":"7mq6d16av","title":"自动分页","date":"2026-06-10","extractedHeadings":[]},"headings":[{"value":"基本用法","depth":2},{"value":"限制返回总条数","depth":2},{"value":"指定每页大小","depth":2},{"value":"与结果过滤组合","depth":2}]}},"pageContext":{"isCreatedByStatefulCreatePages":false,"slug":"7mq6d16av","prev":{"id":"kmq6d0ce1","name":"输出格式与结果过滤","path":"kmq6d0ce1","filePath":"开发参考/CLI 指南/使用 BCE CLI/输出格式与结果过滤.md","seo":null,"parentIds":["qmq6bcxhb","umq6cp6um","emq6ct5jp"],"parents":[{"id":"qmq6bcxhb","documentId":"8554ad10-7e1d-402c-9c1b-a105ffcfff6d","name":"开发参考","repoName":"OpenAPI-Explorer","filePath":"开发参考","disabled":false,"path":"qmq6bcxhb","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":""},{"id":"umq6cp6um","documentId":"4e590dcd-273b-453e-8114-807e659d8f12","name":"CLI 指南","repoName":"OpenAPI-Explorer","filePath":"开发参考/CLI 指南","disabled":false,"path":"umq6cp6um","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":""},{"id":"emq6ct5jp","documentId":"e04d53d3-6dd4-484e-b5a4-c3966c6f8fe0","name":"使用 BCE CLI","repoName":"OpenAPI-Explorer","filePath":"开发参考/CLI 指南/使用 BCE CLI","disabled":false,"path":"emq6ct5jp","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":""}]},"next":null,"parents":[{"id":"qmq6bcxhb","documentId":"8554ad10-7e1d-402c-9c1b-a105ffcfff6d","name":"开发参考","repoName":"OpenAPI-Explorer","filePath":"开发参考","disabled":false,"path":"qmq6bcxhb","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":""},{"id":"umq6cp6um","documentId":"4e590dcd-273b-453e-8114-807e659d8f12","name":"CLI 指南","repoName":"OpenAPI-Explorer","filePath":"开发参考/CLI 指南","disabled":false,"path":"umq6cp6um","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":""},{"id":"emq6ct5jp","documentId":"e04d53d3-6dd4-484e-b5a4-c3966c6f8fe0","name":"使用 BCE CLI","repoName":"OpenAPI-Explorer","filePath":"开发参考/CLI 指南/使用 BCE CLI","disabled":false,"path":"emq6ct5jp","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":""}],"specificSeo":null}}}