6.5. ページネーション制御のある検索の使用

per_page および page ページネーションパラメーターを使用して、API 検索クエリーが返した検索結果を絞り込むことができます。per_page パラメーターは、ページごとに表示する結果数を指定し、page パラメーターは per_page パラメーターの計算に合わせて、どのページを返すかを指定します。

ページネーションパラメーターを指定しない場合に、返す項目数のデフォルト値を 1000 に設定しますが、page パラメーターが指定されている場合には per_page のデフォルト値は 20 が適用されます。

以下の例では、ID が 1 の組織のアクティベーションキーリストを複数ページで返します。このリストには、ページごとにキーが 30 個含まれており、2 ページ目が返されます。

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

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

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

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