lsvolumebackupgeneration

請利用 lsvolumebackupgeneration 指令來列出所指定磁區上任何可用的磁區 Snapshot。

語法


>>- lsvolumebackupgeneration ----------------------------------->

>--+-----------------------------------+-- --+----------+-- ---->
   '- -filtervalue -- attribute_value -'     '- -nohdr -'      

>--+-----------------------+-- --+-----------------+-- --------->
   '- -delim -- delimiter -'     '- -filtervalue? -'      

>--+- -volume --+- volume_name -+-+----------------------------><
   |            '- volume_id ---' |   
   '- -uid -- volume_UID ---------'

參數

-filtervalue attribute=value

（選用）指定一或多個過濾器的清單。只會顯示其值符合過濾器屬性值的物件。

註：當您輸入指令時，某些過濾器可使用萬用字元。使用萬用字元時，會套用下列規則：

萬用字元是星號 (*)。
指令最多可包含一個萬用字元。
使用萬用字元時，請用雙引號 ("") 括住過濾項目。

-nohdr

（選用）依預設，會在簡要樣式視圖中顯示每個資料直欄的標題，以及在詳細樣式視圖中顯示每個資料項目的標題。-nohdr 參數會暫停顯示這些標題。

註：如果沒有要顯示的資料，就不會顯示標題。

-delim delimiter

（選用）依預設，簡要視圖中的所有資料直欄都以空格區隔。每個直欄的寬度都會設為各資料項目的最大寬度。在詳細視圖中，每個資料項目本身都有一列，如果顯示標頭，會用空格來區隔資料與標頭。-delim 參數會置換此行為。-delim 參數的有效輸入為一個單位元組字元。如果您在指令行輸入 -delim :，則會用冒號字元 (:) 來區隔簡要視圖中的所有資料項目；例如，直欄不會出現間距。在詳細視圖中，會用指定的定界字元來區隔資料與其標頭。

-filtervalue?

（選用）顯示有效過濾器屬性的清單。lsvolumebackupgeneration 指令的下列過濾器有效：

state

-volume volume_name | volume_id

（必要）依磁區 ID 或名稱，指定要列出其雲端 Snapshot 的磁區。

註：該磁區必須存在於本端系統上。

磁區 ID 的值必須是數字，磁區名稱的值必須是英數字串。此參數與 -uid 互斥。

-uid volume_UID

（選用）依磁區 UID 指定要列出其雲端 Snapshot 的磁區。此參數與 -volume 互斥。

說明

這個指令會列出指定磁區任何可用的磁區 Snapshot。

這份表格提供可以顯示為輸出視圖資料的屬性值。

表 1. lsvolumebackupgeneration 輸出
屬性	說明
generation_id	指出 Snapshot 產生磁區 ID。值必須是一個數字。
backup_time	指示最新 Snapshot 的時間戳記。該值必須為 `YYMMDDHHMMSS` 格式（或空白）。
volume_group_name	指出磁區群組名稱。值必須是英數字串（或空白）。
volume_size	指出 Snapshot 產生期間磁區的虛擬容量。如果本端系統上有磁區具有所指定的 UID，則此值可能不同於現行磁區大小（容量以 MB 或 GB 為單位）。
類型	指出磁區 Snapshot 產生的類型。值為 `full` 和 `incremental`。
state	指出磁區備份產生的狀態（在雲端系統中）。值如下： `copying` `complete` `deleting`
cloud_upload_size	指示從 Snapshot 產生磁區上傳到雲端系統的資料量（容量以 MB 或 GB 為單位）。

正在複製到雲端帳戶的產生會包含在 copying 狀態值中。正在從雲端帳戶刪除的產生也包含在 deleting 狀態值中。

呼叫範例

lsvolumebackupgeneration -volume 2

結果輸出：

generation_id backup_time   volume_group_name volume_size type        state    cloud_upload_size
1             160217021250                    50.00GB     full        complete 2.83GB
2             160217021355                    50.00GB     incremental complete 177.50MB
3             160218021402                    50.00GB     incremental complete 132.02MB
4             160219021400                    50.00GB     incremental copying  12.43MB

呼叫範例

lsvolumebackupgeneration -uid 600507680CA880AB1200000000000015

結果輸出：

generation_id backup_time   volume_group_name volume_size type state     cloud_upload_size
1             160215021355                    10.00GB     full complete 53.88MB