6.244. 템플릿

새 템플릿을 생성합니다.

이를 위해서는 name 및 vm 요소가 필요합니다. 가상 시스템을 식별하려면 vm.id 또는 vm.name 속성을 사용합니다. 예를 들어 식별자가 123 인 가상 머신에서 템플릿을 생성하려면 다음과 같은 요청을 보냅니다.

POST /ovirt-engine/api/templates

다음과 같이 요청 본문이 있는 경우:

<template>
  <name>mytemplate</name>
  <vm id="123"/>
</template>

버전 4.3부터 스냅샷에서 가상 머신 템플릿을 생성하기 위해 다음과 같이 요청 본문을 보냅니다.

<template>
  <name>mytemplate</name>
  <vm id="123">
    <snapshots>
      <snapshot id="456"/>
    </snapshots>
  </vm>
</template>

템플릿 디스크를 사용자 지정하여 원래 가상 시스템의 디스크와 몇 가지 특성을 다르게 만들 수 있습니다. 이를 위해 vm.disk_attachments 특성을 사용하여 원래 가상 시스템의 디스크 식별자와 변경하려는 특성을 지정합니다. 예를 들어 원래 가상 머신에 식별자 456 이 있는 디스크가 있고 해당 디스크의 경우 이름을 Copy On Write 로 mydisk 형식으로 변경하고 스파스로 설정하려는 경우 다음과 같이 요청 본문을 보냅니다.

<template>
  <name>mytemplate</name>
  <vm id="123">
    <disk_attachments>
      <disk_attachment>
        <disk id="456">
          <name>mydisk</name>
          <format>cow</format>
          <sparse>true</sparse>
        </disk>
      </disk_attachment>
    </disk_attachments>
  </vm>
</template>

템플릿은 기존 템플릿의 하위 버전으로 생성할 수 있습니다. 이를 위해서는 새 템플릿의 name 및 vm 속성과 새 템플릿 버전의 base_template 및 version_name 속성이 필요합니다. base_template 및 version_name 속성은 template 섹션에 묶인 version 섹션 내에 지정해야 합니다. id 또는 name 속성을 사용하여 가상 머신을 식별합니다.

<template>
  <name>mytemplate</name>
  <vm id="123"/>
  <version>
    <base_template id="456"/>
    <version_name>mytemplate_001</version_name>
  </version>
</template>

다음 두 가지 방법 중 하나로 템플릿의 대상 스토리지 도메인을 사용자 지정할 수 있습니다.

POST /ovirt-engine/api/templates?clone_permissions=true

<template>
  <name>mytemplate<name>
  <vm>
    <name>myvm<name>
  </vm>
</template>

가상 머신 템플릿 목록을 반환합니다.

예를 들어 다음과 같습니다.

GET /ovirt-engine/api/templates

는 가상 머신 및 가상 머신 템플릿 목록을 반환합니다.

반환된 템플릿 목록의 순서가 보장되지 않습니다.