vm-reprovision
使用方法
avcli vm-reprovision --name name [--new-name name] [--description "description"] [--cpu number] [--memory size] [--addVolumes volumes] [--deleteVolumes volumes] [--keepVolumes volumes] [--interfaces networks] [--vnc-keyboard-layout keyboard] [--detach-boot-volume] [--attach-boot-volume name]
説明
vm-reprovision コマンドを使用して、指定の VM を再プロビジョニングします。
オプション
| --name name |
再プロビジョニングする VM を指定します。VM の再プロビジョニングは一度に 1 つのみ実行できます。名前または ID で指定します。
|
| --new-name name |
VM の新しい名前を指定します。 |
| --description "description "
|
VM の説明を指定します。 |
| --cpu number |
仮想 CPU の数。デフォルトでは VM の現在値に設定されます。
|
| --memory size |
メモリのメガバイト単位の容量。デフォルトでは VM の現在値に設定されます。 |
| --addVolumes volumes |
この VM に接続するボリュームのリスト。"ボリューム" は、 5 つのコンポーネントで構成されます。各コンポーネントはカンマで区切って指定します。
- ボリュームのサイズ (必須)。
デフォルトではボリューム サイズをメガバイト単位で指定しますが、KB、MB、GB、TB などの標準単位も使用できます。
- ストレージを取得するストレージ グループの名前または ID。
- ボリューム名。
- ボリューム ディスク イメージのフォーマット (raw または qcow2)。
- ボリュームのセクター サイズ (512 または 4096)。
- セクター サイズはバイト (B) で指定します。デフォルト値は 512 B です。
ストレージ グループのセクター サイズが 512 B の場合、ボリュームのセクター サイズも 512 B でなければなりません。 ストレージ グループのセクター サイズが 4096 B (4 kB) の場合、ボリュームのセクター サイズは 512 B と 4096 B の両方がサポートされます。 ブート ボリュームはセクター サイズを 512 B に指定する必要があります。
|
| --deleteVolumes volumes |
指定の VM に現在接続されている、削除するボリュームのリスト。ボリュームは名前または ID で指定します。 |
| --keepVolumes volumes |
指定の VM に現在接続されている、維持するボリュームのリスト。現在接続されていて、このリストに指定されていないボリュームを指定すると、そのボリュームは VM から切断されます (破棄はされません)。ボリュームは名前または ID で指定します。 |
| --interfaces networks |
VM に接続するネットワークのリスト。各ネットワークを 1 度だけ指定できます。プライベート ネットワークは接続できません。 |
| --vnc-keyboard-layout keyboard |
VM に割り当てるキーボード レイアウト。有効なオプションは英語 (en-us)、ドイツ語 (de)、または日本語 (ja) です。デフォルト値は en-us です。 |
| --detach-boot-volume
|
VM のブート ボリュームを切断します。 |
| --attach-boot-volumename
|
この VM の新しいブート ボリュームの名前を指定します。VM に既にブート ボリュームが接続されている場合、--detach-boot-volume も指定する必要があります。そうでない場合、コマンドが失敗します。 |
例
$ avcli vm-reprovision --cpu 2 --name vm1
$ avcli vm-reprovision --cpu 2 --name vm:o100
$ avcli vm-reprovision --cpu 2 --memory 2048 --name vm:o100
次の例は、vm001 という名前で、1 つの CPU、512 MB のメモリ、1,024 MB のボリュームを使用する、network0 に接続された VM を再プロビジョニングした後、そのボリュームに Pool-0001 からストレージを割り当てます。ボリュームの名前は vm001_vol0 です。
$ avcli vm-reprovision --cpu 1 --memory 512 --interfaces network0 \
--addVolumes 1024,Pool-0001,vm001_vol0 --name vm1
次の例は、VM vm1 を再プロビジョニングした後、これに関連付けられた volume:o411、data-vm1、および data-vm2 の各ボリュームを削除します。
$ avcli vm-reprovision --deleteVolumes volume:o411 data-vm1 data-vm2 --name vm1
次の例は、VM vm1 を、新しいデータ ボリューム data-1-7 を使用して再プロビジョニングし、ボリューム volume:o1043 を削除して volume:o1、volume:o2、volume:o4 の各ボリュームを維持したうえで、sharednetwork:o129 と sharednetwork:o130 の各ネットワーク インタフェースを接続します。
$ avcli vm-reprovision --cpu 3 --memory 3359 --addVolume 2500,storagegroup:o54,data-1-7 --deleteVolumes volume:o1043 --keepVolumes volume:o1 volume:o2 volume:o4 --interfaces sharednetwork:o129 sharednetwork:o130 --name vm1
次の例は、前の例と同じパラメータを使用して VM vm1 を再プロビジョニングします。さらに VM 名を vm2 に変更して説明を追加します。
$ avcli vm-reprovision --cpu 3 --memory 3359 --addVolumes 2500,storagegroup:o54,data-1-7,qcow2 --deleteVolumes volume:o1043 --keepVolumes volume:o1 volume:o2 volume:o4 --interfaces sharednetwork:o129 sharednetwork:o130 --name vm1 --new-name vm2 --description "This is the vm description"
次の例は、VM vm001 を再プロビジョニングします。その際、2 つの CPU、2048 MB のメモリ、および 1 つの新しいデータ ボリューム vm001_data1 を持ち、qcow2 フォーマットと 4 kB セクター サイズを使用するよう指定して、さらにボリューム o7517 を維持します。
$ avcli vm-reprovision --cpu 2 --memory 2048 --addVolumes 20GB,storagegroup:o1090,vm001_data1,qcow2,4096 --keepVolumes volume:o7517 --name vm001
2 つの VM のブート ディスクをスワップします。
ブート ボリュームを切断します。
$ avcli vm-reprovision --detach-boot-volume --name p56xen4
ブート ボリュームを切り替えます。
$ avcli vm-reprovision --detach-boot-volume --attach-boot-volume boot-p56xen4 --name p56xen8
切断したブート ボリュームを異なる VM に接続します。
$ avcli vm-reprovision --attach-boot-volume boot-p56xen8 --name p56xen4