15.7. アクション
15.7.1. 仮想マシンのアクションの開始
start アクションは、停止、シャットダウン、または一時停止中の仮想マシンを起動します。
例15.46 仮想マシンを起動するアクション
POST /ovirt-engine/api/vms/5114bb3e-a4e6-44b2-b783-b3eea7d84720/start HTTP/1.1 Accept: application/xml Content-type: application/xml <action/>
start アクションでは、
vm 要素をパラメーターとして提供できます。vm 要素を指定すると、仮想マシンは提供された要素からの値を使用し、起動時にシステム設定を上書きします。REST API の vm 要素で start アクションを使用することは、管理ポータルまたはユーザーポータルの Run Once ウィンドウの使用と同じです。これらの設定は、ユーザーが仮想マシンを停止するまで持続します。これらの要素の例には、os、domain、placement_policy、cdroms、stateless、および display タイプ が含まれます。
例15.47 パラメーターを上書きして仮想マシンを起動するアクション
POST /ovirt-engine/api/vms/5114bb3e-a4e6-44b2-b783-b3eea7d84720/start HTTP/1.1
Accept: application/xml
Content-type: application/xml
<action>
<pause>true</pause>
<vm>
<stateless>true</stateless>
<display>
<type>spice</type>
</display>
<os>
<boot dev="cdrom"/>
</os>
<cdroms>
<cdrom>
<file id="windows-xp.iso"/>
</cdrom>
</cdroms>
<floppies>
<floppy>
<file id="virtio-win_x86.vfd"/>
</floppy>
</floppies>
<domain>
<name>domain.example.com</name>
<user>
<user_name>domain_user</user_name>
<password>domain_password</password>
</user>
</domain>
<placement_policy>
<host id="02447ac6-bcba-448d-ba2b-f0f453544ed2"/>
</placement_policy>
</vm>
</action>
注記
domain要素は、起動時にパラメーターを上書きするためにのみ Windows システムに使用されます。domain要素は、Windows 仮想マシンが参加するドメインを決定します。ドメインがdomainsコレクションに存在しない場合は、この要素には、user_namepasswordを含む追加のユーザー認証の詳細が必要です。ドメインがdomainsコレクションに存在する場合は、アクションに追加のユーザー認証の詳細は必要ありません。- CD イメージとフロッピーディスクファイルは、すでに ISO ドメインで利用できる必要があります。そうでない場合は、ISO アップローダーツールを使用してファイルをアップロードします。詳細 は、ISO アップローダーツール を参照してください。
