6.214. StorageDomainVm
| 名前 | 概要 |
|---|---|
|
| |
|
| エクスポートストレージドメインから仮想マシンをインポートします。 |
|
| |
|
| エクスポートストレージドメインから仮想マシンを削除します。 |
6.214.1. get GET
| 名前 | タイプ | 方向 | 概要 |
|---|---|---|---|
|
| In | たどる 必要のある内部リンクを指定します。 | |
|
| Out |
6.214.1.1. follow
たどる 必要のある内部リンクを指定します。これらのリンクで参照されるオブジェクトは、現在の要求の一部としてフェッチされます。詳細は、こちら を参照してください。
6.214.2. import POST
エクスポートストレージドメインから仮想マシンをインポートします。
たとえば、次のようなリクエストを送信します。
POST /ovirt-engine/api/storagedomains/123/vms/456/import
リクエスト本文は以下のようになります。
<action>
<storage_domain>
<name>mydata</name>
</storage_domain>
<cluster>
<name>mycluster</name>
</cluster>
</action>
仮想マシンを新しいエンティティーとしてインポートするには、clone パラメーターを追加します。
<action>
<storage_domain>
<name>mydata</name>
</storage_domain>
<cluster>
<name>mycluster</name>
</cluster>
<clone>true</clone>
<vm>
<name>myvm</name>
</vm>
</action>
インポートするディスクを選択するために、オプションの disks パラメーターを含めます。たとえば、123 と 456 の識別子を持つテンプレートのディスクをインポートするには、以下のリクエスト本文を送信します。
<action>
<cluster>
<name>mycluster</name>
</cluster>
<vm>
<name>myvm</name>
</vm>
<disks>
<disk id="123"/>
<disk id="456"/>
</disks>
</action>クラスター ID または名前を指定せずにエンティティーを登録すると、エンティティーの OVF からのクラスター名が使用されます (登録要求にクラスターマッピングも含まれていない場合)。
| 名前 | タイプ | 方向 | 概要 |
|---|---|---|---|
|
| In | インポートを非同期で実行する必要があるかどうかを示します。 | |
|
| In | インポートされた仮想マシンの識別子を再生成する必要があるかどうかを示します。 | |
|
| In | ||
|
| In | スナップショットのない仮想マシンになるように、インポートされた仮想マシンのスナップショットを折りたたむ必要があることを示します。 | |
|
| In | ||
|
| In | ||
|
| In |
6.214.2.1. clone
インポートされた仮想マシンの識別子を再生成する必要があるかどうかを示します。
デフォルトでは、仮想マシンがインポートされると、識別子が保持されます。つまり、識別子は一意である必要があるため、同じ仮想マシンを複数回インポートすることはできません。同じマシンを複数回インポートできるようにするには、このパラメーターを true に設定します。デフォルトは false です。
6.214.2.2. collapse_snapshots
スナップショットのない仮想マシンになるように、インポートされた仮想マシンのスナップショットを折りたたむ必要があることを示します。
このパラメーターはオプションであり、明示的に指定されていない場合、デフォルト値は false です。
6.214.3. register POST
| 名前 | タイプ | 方向 | 概要 |
|---|---|---|---|
|
| In | 仮想マシンをその一部のディスクのみに登録できるかどうかを示します。 | |
|
| In | 登録を非同期的に実行するかどうかを指定します。 | |
|
| In | ||
|
| In | ||
|
| In | エンジンによるインポートプロセス中に、問題のある MAC アドレスを再割り当てする必要があるかどうかを示します。 | |
|
| In | このパラメーターは、仮想マシンを登録する方法を記述します。 | |
|
| In | ||
|
| In | インポート/登録プロセス中に適用される仮想 NIC プロファイルのマッピングルールを記述する非推奨となった属性。 |
6.214.3.1. allow_partial_import
仮想マシンをその一部のディスクのみに登録できるかどうかを示します。
このフラグが true の場合、イメージが見つからなくても、エンジンは検証プロセスで失敗しませんが、代わりに、欠落しているディスクなしで仮想マシンを登録できます。これは主に、一部のストレージドメインが使用できない場合の仮想マシンの登録中に使用されます。デフォルト値は false です。
6.214.3.2. reassign_bad_macs
エンジンによるインポートプロセス中に、問題のある MAC アドレスを再割り当てする必要があるかどうかを示します。
次のいずれかに該当する場合、MAC アドレスは問題のあるものと見なされます。
- ターゲット環境の仮想マシンに既に割り当てられている MAC アドレスと競合する。
- 対象 MAC アドレスプールの範囲外である。
6.214.3.3. registration_configuration
このパラメーターは、仮想マシンを登録する方法を記述します。
このパラメーターは任意です。パラメーターが指定されていない場合、仮想マシンは、作成された元の環境と同じ設定で登録されます。
6.214.3.4. vnic_profile_mappings
インポート/登録プロセス中に適用される仮想 NIC プロファイルのマッピングルールを記述する非推奨となった属性。
この属性は、エンジンのバージョン 4.2.1 以降は非推奨となっており、後方互換性のためにのみ保持されていることに注意してください。これは今後削除されます。vnic_profile_mappings を指定するには、RegistrationConfiguration タイプ内の vnic_profile_mappings 属性を使用します。
6.214.4. remove DELETE
エクスポートストレージドメインから仮想マシンを削除します。
たとえば、仮想マシン 456 をストレージドメイン 123 から削除するには、以下のようなリクエストを送信します。
DELETE /ovirt-engine/api/storagedomains/123/vms/456
| 名前 | タイプ | 方向 | 概要 |
|---|---|---|---|
|
| In | 削除を非同期的に実行するかどうかを指定します。 |
