5.238. Vms
이름 | 요약 |
---|---|
| 새 가상 머신을 생성합니다. |
|
5.238.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>
모든 경우에 가상 머신이 생성될 클러스터의 이름 또는 식별자가 필요합니다.
이름 | 유형 | direction | 요약 |
---|---|---|---|
| in | 가상 머신이 템플릿과 독립적이어야 하는지 지정합니다. | |
| in | 템플릿의 권한을 가상 머신에 복사해야 하는지 여부를 지정합니다. | |
| in/Out |
5.238.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
를 사용할 때와 같이 템플릿의 권한도 복사됩니다.
5.238.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>