restorevolume

使用 restorevolume 指令，從某一代 Snapshot 來還原磁區。

語法


>>-restorevolume--+-----------------------------------------+--->
                  '- -fromuid--volume_UID--+--------------+-'   
                                           '- -restoreuid-'     

>--+----------------------+--+--------------------------+------->
   '- -generation--gen_id-'  '- -deletelatergenerations-'   

>--+----------+--+-volume_name-+-------------------------------><
   '- -cancel-'  '-volume_id---'

參數

-fromuid volume_UID: （選用）指定要還原的磁區 Snapshot（依磁區 UID 指定）。此值必須是一個數字。
請利這個參數，從不同磁區來還原 Snapshot。這表示指定的 UID 必須不同於要還原的磁區的 UID（當您指定 volume_name 或 volume_id 時）。
註：如果您指定這個參數，則要還原的磁區不能啟用雲端 Snapshot。
-restoreuid: （選用）指定所還原之磁區的 UID（應設為正在還原之磁區 Snapshot 的 UID）。這個參數必須與 -fromuid 一起指定。
-generation gen_id: （選用）指定要還原的 Snapshot 世代。此值必須是一個數字。
-deletelatergenerations: （選用）指定在還原世代之後，應該刪除所有的 Snapshot 世代。
註：如果磁區已啟用雲端 Snapshot，且要還原的世代不是磁區的最新 Snapshot，則需要這個參數。
-cancel: （選用）取消還原作業。
volume_name | volume_id: （必要）指定要還原的磁區名稱或 ID。磁區 ID 的值必須是數字，磁區名稱的值必須是英數字串。

說明

這個指令會從某一代 Snapshot 來還原磁區。

還原作業會直接在以磁區名稱或磁區 ID 所指定的磁區上執行（不使用暫存磁區）。在進行還原作業時，磁區處於 offline 狀態。如果還原程序在完成之前取消，磁區上的資料會變得不一致且無法使用。

呼叫範例

還原磁區 volume7 更早的世代（第 3 代）：

restorevolume -generation 3 -deletelatergenerations volume7

結果輸出：

No feedback

呼叫範例

還原磁區 ID 7 最新的 Snapshot（第 5 代）：

restorevolume -generation 5 volume7

結果輸出：

No feedback

呼叫範例

restorevolume -generation 1 -fromuid 6005076400B70038E00000000000001C 1

結果輸出：

No feedback