Red Hat Training

A Red Hat training course is available for Red Hat Virtualization

6.243. Vms

표 6.771. 방법 요약

이름요약

add

새 가상 머신을 생성합니다.

list

 

6.243.1. POST추가

새 가상 머신을 생성합니다.

가상 머신은 다음과 같은 다양한 방법으로 생성할 수 있습니다.

  • 템플릿을 통해 다음을 수행합니다. 이 경우 템플릿의 식별자 또는 이름을 제공해야 합니다. 예를 들어 일반 쉘 스크립트 및 XML을 사용합니다.
#!/bin/sh -ex

url="https://engine.example.com/ovirt-engine/api"
user="admin@internal"
password="..."
curl \
--verbose \
--cacert /etc/pki/ovirt-engine/ca.pem \
--user "${user}:${password}" \
--request POST \
--header "Version: 4" \
--header "Content-Type: application/xml" \
--header "Accept: application/xml" \
--data '
<vm>
  <name>myvm</name>
  <template>
    <name>Blank</name>
  </template>
  <cluster>
    <name>mycluster</name>
  </cluster>
</vm>
' \
"${url}/vms"
  • 스냅샷에서 다음을 수행합니다. 이 경우 스냅샷의 식별자를 제공해야 합니다. 예를 들어 일반 파일 스크립트 및 XML을 사용합니다.
#!/bin/sh -ex

url="https://engine.example.com/ovirt-engine/api"
user="admin@internal"
password="..."
curl \
--verbose \
--cacert /etc/pki/ovirt-engine/ca.pem \
--user "${user}:${password}" \
--request POST \
--header "Content-Type: application/xml" \
--header "Accept: application/xml" \
--data '
<vm>
  <name>myvm</name>
  <snapshots>
    <snapshot id="266742a5-6a65-483c-816d-d2ce49746680"/>
  </snapshots>
  <cluster>
    <name>mycluster</name>
  </cluster>
</vm>
' \
"${url}/vms"

템플릿 또는 스냅샷에서 가상 머신을 생성할 때 일반적으로 가상 시스템의 디스크를 생성할 스토리지 도메인을 명시적으로 표시하는 것이 유용합니다. 가상 머신이 템플릿에서 생성되면 매핑을 나타내는 disk_attachment 요소 집합이 전달됩니다.

<vm>
  ...
  <disk_attachments>
    <disk_attachment>
      <disk id="8d4bd566-6c86-4592-a4a7-912dbf93c298">
        <storage_domains>
          <storage_domain id="9cb6cb0a-cf1d-41c2-92ca-5a6d665649c9"/>
        </storage_domains>
      </disk>
    <disk_attachment>
  </disk_attachments>
</vm>

스냅샷에서 가상 머신을 생성하면 이 디스크 세트가 약간 다르므로 id 대신 image_id 특성을 사용합니다.

<vm>
  ...
  <disk_attachments>
    <disk_attachment>
      <disk>
        <image_id>8d4bd566-6c86-4592-a4a7-912dbf93c298</image_id>
        <storage_domains>
          <storage_domain id="9cb6cb0a-cf1d-41c2-92ca-5a6d665649c9"/>
        </storage_domains>
      </disk>
    <disk_attachment>
  </disk_attachments>
</vm>

XML 설명에 추가 가상 머신 매개변수를 지정할 수 있습니다(예: 데스크탑 유형의 가상 머신) 2GiB RAM과 추가 설명은 다음과 같은 요청 본문을 보낼 수 있습니다.

<vm>
  <name>myvm</name>
  <description>My Desktop Virtual Machine</description>
  <type>desktop</type>
  <memory>2147483648</memory>
  ...
</vm>

부팅 가능한 CDROM 장치는 다음과 같이 설정할 수 있습니다.

<vm>
  ...
  <os>
    <boot dev="cdrom"/>
  </os>
</vm>

CDROM에서 부팅하려면 먼저 CDROM 서비스에 설명된 대로 디스크를 삽입해야 합니다. 그런 다음 os.boot.devices 특성을 사용하여 해당 CDROM에서 부팅을 지정할 수 있습니다.

<vm>
  ...
  <os>
    <boot>
      <devices>
        <device>cdrom</device>
      </devices>
    </boot>
  </os>
</vm>

모든 경우에 가상 머신이 생성될 클러스터의 이름 또는 식별자가 필요합니다.

표 6.772. 매개변수 요약

이름유형direction요약

clone

부울

in

가상 머신이 템플릿과 독립적이어야 하는지 지정합니다.

clone_permissions

부울

in

템플릿의 권한을 가상 머신에 복사해야 하는지 여부를 지정합니다.

vm

VM

in/Out

 

6.243.1.1. clone

가상 머신이 템플릿과 독립적이어야 하는지 지정합니다.

기본적으로 템플릿에서 가상 머신을 생성하는 경우 가상 머신의 디스크가 템플릿의 디스크에 따라 달라지는 경우 템플릿의 차이점만 실제 스토리지 공간을 차지하도록 쓰기 메커니즘에서 복사 를 사용합니다. 이 매개변수가 지정되고 값이 true 이면 생성된 가상 시스템의 디스크가 복제되고 템플릿과 관계없이 복제됩니다. 예를 들어 독립 가상 머신을 생성하려면 다음과 같은 요청을 보냅니다.

POST /ovirt-engine/vms?clone=true

다음과 같은 요청 본문이 있습니다.

<vm>
  <name>myvm<name>
  <template>
    <name>mytemplate<name>
  </template>
  <cluster>
    <name>mycluster<name>
  </cluster>
</vm>
참고

이 매개변수가 true 인 경우 clone_permissions=true 를 사용할 때와 같이 템플릿의 권한도 복사됩니다.

6.243.1.2. clone_permissions

템플릿의 권한을 가상 머신에 복사해야 하는지 여부를 지정합니다.

이 선택적 매개변수가 제공되고 해당 값이 true 인 경우 템플릿의 권한(필수된 권한만 제외)은 생성된 가상 머신에 복사됩니다. 예를 들어, 권한을 복사하는 mytemplate 템플릿에서 가상 머신을 생성하려면 다음과 같이 요청을 보냅니다.

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

다음과 같은 요청 본문이 있습니다.

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