7.3.7. 쿼리 구문
API는 URI 템플릿을 사용하여
GET 요청과 함께 검색 쿼리를 수행합니다.
GET /ovirt-engine/api/collection?search={query} HTTP/1.1
Accept: application/xml
쿼리 템플릿 값은 API에서 컬렉션을 지시하는 검색 쿼리를 참조합니다. 이 쿼리 는 Red Hat Virtualization 쿼리 언어와 동일한 형식을 사용합니다.
(crite metric) [sortby (element) asc|desc]
sortby 절은 선택 사항이며 결과를 정렬할 때만 필요합니다.
| 소프트웨어 컬렉션 | 기준 | 결과 |
|---|---|---|
호스트 | vms.status=up | 가동 중인 가상 시스템을 실행하는 모든 호스트 목록을 표시합니다. |
vms | domain=qa.company.com | 지정된 도메인에서 실행 중인 모든 가상 머신 목록을 표시합니다. |
vms | users.name=mary | 사용자 이름이 mary 인 사용자에 속하는 모든 가상 머신 목록을 표시합니다. |
이벤트 | severity>normal sortby 시간 | 심각도가 정상 보다 높은 모든 이벤트 목록을 표시하고 시간 요소 값으로 정렬합니다. |
이벤트 | severity>normal sortby 시간 desc | 심각도가 정상 보다 높은 모든 이벤트 목록을 표시하고 시간 요소 값을 순서대로 정렬합니다. |
API를 사용하려면
쿼리 템플릿을 URL로 인코딩하여 예약한 문자(예: 연산자 및 공백)를 변환해야 합니다.
예 7.3. URL 인코딩 검색 쿼리
GET /ovirt-engine/api/vms?search=name%3Dvm1 HTTP/1.1 Accept: application/xml
