3.7. 검색

일부 서비스의 list 메서드에는 검색 기준을 지정하는 데 사용할 수 있는 search 매개변수가 있습니다. 사용할 때 서버는 해당 조건을 충족하는 컬렉션 내의 오브젝트만 반환합니다. 예를 들어 다음 요청은 myvm 이라는 가상 시스템만 반환합니다.

GET /ovirt-engine/api/vms?search=name%3Dmyvm

GET /ovirt-engine/api/vms?search=name%3Dmyvm

Copy to Clipboard

Toggle word wrap

max 매개변수를 사용하여 반환된 오브젝트 수를 제한합니다. 예를 들어 다음 요청은 시스템에서 사용 가능한 수에 관계없이 하나의 가상 머신만 반환합니다.

GET /ovirt-engine/api/vms?max=1

GET /ovirt-engine/api/vms?max=1

Copy to Clipboard

Toggle word wrap

max 매개변수가 없는 검색 요청은 모든 오브젝트를 반환합니다. 시스템의 전반적인 성능에서 요청의 영향을 줄이기 위해 max 매개변수를 지정하는 것이 좋습니다.

맨 위로 이동