7.3.9. 페이지 번호
일부 Red Hat Virtualization 환경에는 대규모 리소스 컬렉션이 포함되어 있습니다. 그러나 API는 하나의 검색 쿼리에 대한 기본 리소스 수만 컬렉션에 표시합니다. 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
이 쿼리는 선택한 요소에서 주문한 컬렉션 목록에 두 번째 페이지를 표시합니다.
중요
REST API는 상태 비저장입니다. 모든 요청이 서로 독립적이므로 다른 요청 간에 상태를 유지할 수 없습니다. 결과적으로 요청 간에 상태 변경이 발생하면 페이지 결과가 일치하지 않을 수 있습니다.
예를 들어 VM 목록에서 특정 페이지를 요청하고 다음 페이지를 요청하기 전에 상태 변경이 발생하면 결과가 누락되거나 중복된 항목이 포함될 수 있습니다.
