6.279. VmPools
가상 머신 풀에 대한 읽기-쓰기 액세스 권한을 제공합니다.
이름 | 요약 |
---|---|
| 새 가상 머신 풀을 생성합니다. |
| 사용 가능한 가상 시스템 풀 목록을 가져옵니다. |
6.279.1. POST추가
새 가상 머신 풀을 생성합니다.
새 풀에는 이름
,클러스터
및 템플릿
속성이 필요합니다. id
또는 name
중첩된 속성을 사용하여 클러스터와 템플릿을 식별합니다.
POST /ovirt-engine/api/vmpools
다음 본문으로:
<vmpool> <name>mypool</name> <cluster id="123"/> <template id="456"/> </vmpool>
이름 | 유형 | 방향 | 요약 |
---|---|---|---|
| in/Out | 추가할 풀입니다. | |
| in | 풀에 생성된 가상 머신이 생성 후 밀봉되어야 하는지 여부를 지정합니다. |
6.279.1.1. seal
풀에 생성된 가상 머신이 생성 후 밀봉되어야 하는지 여부를 지정합니다.
이 선택적 매개 변수가 제공되며 해당 값이 true
인 경우 풀에 생성된 가상 머신은 생성 후 봉인됩니다. 값이 'false'이면 가상 머신이 봉인되지 않습니다. 매개 변수를 제공하지 않으면 가상 머신이 밀봉된 템플릿에서 생성되고 게스트 OS가 Windows로 설정되지 않은 경우에만 봉인됩니다. 이 매개변수는 풀이 생성될 때 생성된 가상 머신에만 영향을 미칩니다.
예를 들어 5개의 가상 시스템이 있는 가상 시스템 풀을 생성하고 이를 봉인하려면 다음과 같은 요청을 보냅니다.
POST /ovirt-engine/api/vmpools?seal=true
다음 본문으로:
<vmpool> <name>mypool</name> <cluster id="123"/> <template id="456"/> <size>5</size> </vmpool>
6.279.2. GET나열
사용 가능한 가상 시스템 풀 목록을 가져옵니다.
GET /ovirt-engine/api/vmpools
다음 응답을 받게 됩니다.
<vm_pools> <vm_pool id="123"> ... </vm_pool> ... </vm_pools>
반환된 풀 목록의 순서는 sortby
절이 검색
매개 변수에 포함된 경우에만 보장됩니다.
이름 | 유형 | 방향 | 요약 |
---|---|---|---|
| in |
검색 매개 변수를 사용하여 수행된 검색이 대소문자를 고려하여 수행해야 하는지 여부를 나타냅니다. | |
| in | 사용자의 권한에 따라 결과를 필터링해야 하는지 여부를 나타냅니다. | |
| in | 따라야 할 내부 링크를 나타냅니다. | |
| in | 반환할 최대 풀 수를 설정합니다. | |
| Out | 검색된 풀입니다. | |
| in | 반환된 풀을 제한하는 데 사용되는 쿼리 문자열입니다. |
6.279.2.1. case_sensitive
검색 매개 변수를 사용하여 수행된 검색이 대소문자를 고려하여 수행해야 하는지 여부를 나타냅니다. 기본값은
true
입니다. 즉, 해당 케이스가 고려됩니다. 대소문자를 무시하고자 하는 경우 false
로 설정합니다.
6.279.2.2. 팔로우
따라야 할 내부 링크를 나타냅니다. 이러한 링크에서 참조하는 오브젝트는 현재 요청의 일부로 가져옵니다. 자세한 내용은 여기를 참조하십시오.
6.279.2.3. max
반환할 최대 풀 수를 설정합니다. 이 값을 지정하지 않으면 모든 풀이 반환됩니다.