Red Hat Training

A Red Hat training course is available for Red Hat Virtualization

3.7.5. 페이지 번호

일부 Red Hat Virtualization 환경에는 대규모 오브젝트 컬렉션이 포함되어 있습니다. 한 요청으로 모두 검색하는 것은 실용적이지 않으며 성능이 저하됩니다. 페이지별로 검색할 수 있도록 검색 매개변수는 선택적 page 절을 지원합니다. max 매개변수와 결합된 이 값은 페이징의 기본입니다. 예를 들어 페이지 크기가 10개의 가상 머신인 가상 머신의 첫 페이지를 가져오려면 다음과 같이 요청을 보냅니다.

GET /ovirt-engine/api/vms?search=page%201&max=10
참고

search 매개변수는 URL로 인코딩되며 인코딩하기 전에 검색 매개변수의 실제 값은 1 페이지 이므로 실제로 첫 번째 페이지를 요청합니다.

다음 페이지를 검색할 페이지 값을 늘립니다.

GET /ovirt-engine/api/vms?search=page%202&max=10

page 절은 search 매개변수 내의 다른 절과 함께 사용할 수 있습니다. 예를 들어 다음 요청은 가상 머신의 두 번째 페이지를 반환하지만 이름별로 정렬합니다.

GET /ovirt-engine/api/vms?search=sortby%20name%20page%202&max=10
중요

API는 상태 비저장입니다. 모든 요청이 서로 독립적이므로 서로 다른 요청 간에 상태를 유지할 수 없습니다. 결과적으로 요청 간에 상태 변경이 발생하면 페이지 결과가 일치하지 않을 수 있습니다.

예를 들어 가상 머신 목록에서 특정 페이지를 요청하고 다음 페이지를 요청하기 전에 가상 머신이 생성 또는 제거되면 결과 일부가 누락되거나 중복이 포함될 수 있습니다.