4.5. ページネーション制御のある検索の使用
ページネーションパラメーター
per_page および page を使用して、API 検索クエリーが返す検索結果を絞り込むことができます。per_page パラメーターは、ページごとの項目数を指定し、page パラメーターは、per_page パラメーターで算出された数値をもとにどのページを返すかを指定します。
ページネーションパラメーターを指定しない場合に、返す項目数のデフォルト値を 1000 に設定しますが、
page パラメーターが指定されている場合にはper_page のデフォルト値は 20 が適用されます。
例4.6 コンテンツビューの表示
以下の例では、返された結果の 3 ページ目の 10 件分をリストするコンテンツビューが表示されます。
curl -X GET --user sat_username:sat_password \ "https://satellite6.example.com/katello/api/content_views?per_page=10&page=3"
$ curl -X GET --user sat_username:sat_password \
"https://satellite6.example.com/katello/api/content_views?per_page=10&page=3"
例4.7 アクティベーションキーの表示
以下の例では、ID が 1 の組織のアクティベーションキー 30 個を 1 ページにリストする検索の 2 ページ目を表示します。
curl -X GET --user sat_username:sat_password \ "https://satellite6.example.com/katello/api/activation_keys?organization_id=1&per_page=30&page=2"
$ curl -X GET --user sat_username:sat_password \
"https://satellite6.example.com/katello/api/activation_keys?organization_id=1&per_page=30&page=2"
複数ページを表示する結果を取得するには、for loop の構造を使用します。
例4.8 複数ページを返す設定
以下の例では、ページごとに 5 件ずつ表示するコンテンツビュー 3 ページ分の 1 ページを返します。
for i in `seq 1 3`; do curl -X GET --user sat_username:sat_password \ "https://satellite6.example.com/katello/api/content_views?per_page=5&page=$i"; done
$ for i in `seq 1 3`; do curl -X GET --user sat_username:sat_password \
"https://satellite6.example.com/katello/api/content_views?per_page=5&page=$i"; done