7.3.9. ページネーション
一部の Red Hat Virtualization 環境には、大規模なリソースコレクションが含まれています。ただし、API はコレクションへの 1 つの検索クエリーのデフォルトリソースのみを表示します。デフォルト以外のものを表示するには、API は page コマンドを含む検索クエリーでコレクションを
ページ に分割します。
例7.6 リソースのページネーション
この例では、コレクションのリソースをページ分割します。URL でエンコードされたリクエストは以下のとおりです。
GET /ovirt-engine/api/collection?search=page%201 HTTP/1.1 Accept: application/xml
ページ 値を増やして、結果の次のページを表示します。
GET /ovirt-engine/api/collection?search=page%202 HTTP/1.1 Accept: application/xml
page コマンドを検索クエリーの他のコマンドと併用します。以下に例を示します。
GET /ovirt-engine/api/collection?search=sortby%20element%20asc%20page%202 HTTP/1.1 Accept: application/xml
このクエリーは、選択した要素によって順序付けされたコレクションリストに 2 番目のページを表示します。
重要な影響
REST API はステートレスです。すべてのリクエストは互いに独立しているため、異なるリクエスト間で状態を維持することはできません。その結果、要求間でステータスが変更されると、ページの結果に一貫性がなくなることがあります。
たとえば、仮想マシンの一覧から特定のページを要求し、次のページを要求する前にステータスの変更が発生すると、結果にエントリーがない、または重複エントリーが含まれる可能性があります。
