vm-reprovision

使用方法

avcli vm-reprovision --name name [--new-name name] [--description "description"] [--cpu number] [--memory size] [--addVolumes volumes] [--deleteVolumes volumes] [--keepVolumes volumes] [--interfaces networks] [--disabled-interfaces networks] [--detach-boot-volume] [--attach-boot-volume name]

説明

vm-reprovision コマンドを使用して、指定の VM を再プロビジョニングします。

オプション

--name name

再プロビジョニングする VM を指定します。VM の再プロビジョニングは一度に 1 つのみ実行できます。VM は名前または ID で指定します。
--new-name name VM の新しい名前を指定します。
--description "description " VM の説明を指定します。
--cpu number

仮想 CPU の数。デフォルトでは VM の現在値に設定されます。
--memory size メモリのメガバイト単位の容量。デフォルトでは VM の現在値に設定されます。
--addVolumes volumes

この VM に接続するボリュームのリスト。各 volume は次の 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 で指定します。
--interfacesnetworks, MAC address VM に接続するネットワークのリスト。各ネットワークを 1 度だけ指定できます。プライベート ネットワークは接続できません。オプションで、ネットワーク名の後に MAC アドレスを指定します。
--disabled-interfaces networks, MAC address 有効にしない状態で VM に接続するネットワークのリスト。各ネットワークを 1 度だけ指定できます。プライベート ネットワークは接続できません。オプションで、ネットワーク名の後に MAC アドレスを指定します。
--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