5.6. 使用带有分页控制的搜索


您可以使用 per_pagepage 分页参数来限制 API 搜索查询返回的搜索结果。per_ page 参数指定每个页面的结果数,page 参数指定按 per_page 参数计算的结果数,以返回。

当您没有指定任何分页参数时,要返回的默认项目数设置为 1000,但 per_page 值在指定 page 参数时应用默认值为 20。

列出内容视图

本例在页面中返回内容视图的列表。列表中每页包含 10 个密钥,并返回第三页。

请求示例:

$ curl --request GET --user sat_username:sat_password \
https://satellite.example.com/katello/api/content_views?per_page=10&page=3

列出激活码

这个示例返回有 ID 为 1 的机构的激活码列表。列表中包含每个页面 30 个密钥,并返回第二个页面。

请求示例:

$ curl --request GET --user sat_username:sat_password \
https://satellite.example.com/katello/api/activation_keys?organization_id=1&per_page=30&page=2

返回多个页面

您可以使用 for 循环结构来获取多个结果页面。

这个示例将第 1 页返回到内容视图的第 3 页,每个页面有 5 个结果:

$ for i in seq 1 3; do \
curl --request GET --user sat_username:sat_password \
https://satellite.example.com/katello/api/content_views?per_page=5&page=$i; \
done
Red Hat logoGithubRedditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

© 2024 Red Hat, Inc.