檢視 Block Storage for VPC Snapshot 及一致性群組

檢視 Block Storage for VPC 的快照與一致性群組,包括各快照及其屬性的詳細資訊。

在主控台中列出快照

您可以使用使用者介面來列出 Snapshot 及一致性群組。

在主控台中列出所有快照

在主控台中,您可以檢視您建立的所有 Snapshot 的清單,最新的 Snapshot 位於清單的開頭。 您可以過濾清單以檢視特定 Snapshot。

  1. IBM Cloud控制台中,按一下導航選單圖示選單圖示> 基礎架構VPC 圖示> 儲存 > VPC 的Block Storage快照。 頁面有兩個主要標籤: Snapshot 一致性群組和 Snapshot。

  2. 選取「快照」索引標籤。 會列出特定區域的 Snapshot。 如果您想要查看另一個區域中的 Snapshot,請按一下箭頭來展開清單並選取不同的區域。 依預設,最新的 Snapshot 會顯示在清單開頭。

  3. 隨著 Snapshot 清單成長,請使用過濾器來指出每頁要顯示的 Snapshot 數目。 使用頁面導覽箭頭在清單中向前及向後移動。

表 1 說明 Snapshot 清單上顯示的所有 Snapshot 的資訊。

所有快照列表
欄位 說明
名稱 您建立 Snapshot 時提供的名稱。 按一下 Snapshot 的名稱,以查看其 詳細資料
狀態 Snapshot 的狀態,視它是可使用 (作用中 狀態)、無法使用或正在建立而定。 如需相關資訊,請參閱 Snapshot 狀態
大小 Snapshot 的大小 (GB)。 其大小是從來源卷繼承而來的。
來源磁區 它會顯示從中建立 Snapshot 的開機或資料磁區。 按一下磁區名稱以查看其 詳細資料
Snapshot 副本 Snapshot 在其他區域中具有的副本數。
建立日期 建立快照時的當地日期和時間。
一致性群組 如果 Snapshot 是 Snapshot 集的成員,這個欄位會顯示一致性群組的名稱。

按一下「設定」圖示 「設定」圖示,以顯示您可以新增至表格的選用欄位。

所有快照的可選資訊欄位列表
欄位 說明
加密 它顯示 IBM管理的加密客戶管理的加密。 此加密設定是從原始卷繼承而來的。
快速還原狀態 它表示快照是否可用快速還原複製。 可能的狀態有啟用、待定或停用。
資源群組 該快照所屬的資源群組。
可開機 是或否。 它會顯示是否已取得啟動磁區或資料磁區的 Snapshot。
建立者 它會顯示 Snapshot 是由使用者建立,還是由 備份原則 建立。
世代 Gen 1 或 Gen 2,此值會根據其磁碟區配置文件從父磁碟區繼承。

透過按一下「動作」圖示 「動作」圖示,您可以顯示快速特定動作的功能表。

您亦可從卷宗詳情頁面列出所有從 Block Storage for VPC 該卷宗建立的快照。 如需更多資訊,請 閱檢視從該 Block Storage for VPC 卷創建的所有快照。

在主控台中檢視快照詳細資訊

若要查看 Snapshot 的詳細資訊,請在 VPC 清單的 Block Storage Snapshot 上找到 Snapshot。 然後,按一下 Snapshot 的名稱。 詳細資料頁面會在標題中顯示 Snapshot 的名稱、其狀態及附加的使用者標籤。

Snapshot 詳細資料畫面會顯示下表中說明的資訊。

Snapshot 詳細資料
欄位 說明
名稱 Snapshot 的名稱,您可以按一下 編輯圖示 「編輯」圖示 來變更。 如需相關資訊,請參閱 命名 Snapshot
Snapshot ID Snapshot 的可複製 GUID。
可開機 是或否。
CRN Snapshot 的可複製 CRN。
資源群組 設定 VPC 時所定義的資源群組。
建立日期 Snapshot 資源建立程序開始的日期和時間。
擷取日期 擷取此 Snapshot 的日期和時間。
建立者 此欄位顯示 UserBackup policy。 如果 Snapshot 是由備份原則所建立,使用者介面也會顯示建立備份 Snapshot 之備份計劃的名稱。
大小 Snapshot 的大小 (GB),繼承自來源磁區。
來源磁區 從中取得第一個 Snapshot 的來源磁區。 按一下鏈結以取得磁區詳細資料。 如果已刪除磁區,則會出現沒有鏈結的名稱。
加密 提供者管理或客戶管理的加密。 對於客戶管理的加密,會顯示 KMS 實例、主要金鑰名稱及主要金鑰 ID。
世代 根據來源磁碟區的磁碟區配置文件,此值為 Gen 1 或 Gen 2。
虛擬伺服器表示式 允許使用表達式定義並限制可開機快照與哪些虛擬伺服器設定檔相容。 當您使用快照配置虛擬伺服器實體時,表達式會與要求的實體屬性進行比對。 如需詳細資訊,請參閱 在自訂影像中加入允許使用的表達式
快速還原畫面 使用 快速還原,從這個完全供應的 Snapshot 建立磁區。 按一下 編輯,以在區域中 啟用或停用快速還原
一致性群組畫面 它會顯示 Snapshot 所屬一致性群組的相關資訊。 按一下 建立虛擬伺服器,以從一致性群組還原磁區。

透過按一下「動作」圖示 「動作」圖示,您可以顯示快速特定動作的功能表。

在主控台中列出所有快照的一致性群組

在主控台中,您可以檢視您所建立的所有一致性群組的清單,最新的一致性群組位於清單的開頭。 您可以過濾清單以檢視特定的一致性群組。

  1. IBM Cloud控制台中,按一下導航選單圖示選單圖示> 基礎架構VPC 圖示> 儲存 > VPC 的Block Storage快照。 頁面有兩個主要標籤: Snapshot 一致性群組和 Snapshot。

  2. 選取 Snapshot 一致性群組 標籤。 會列出特定地區的群組。 如果您想要查看另一個區域中的一致性群組,請按一下箭頭來展開清單,並選取不同的區域。 依預設,最新的 Snapshot 群組會顯示在清單的開頭。

  3. 隨著一致性群組清單的增長,請使用過濾器來指出每頁要顯示的項目數。 使用頁面導覽箭頭在清單中向前及向後移動。

下表說明清單中所有一致性群組的資訊。

所有一致性組的列表
欄位 說明
名稱 您建立一致性群組時所提供的名稱。 按一下群組名稱以查看其 詳細資料
狀態 一致性群組的狀態,視它是可用 (作用中 狀態)、無法使用或正在建立而定。
來源 VSI 它顯示包含一致性群組中 Snapshot 的來源磁區的虛擬伺服器實例。 按一下虛擬伺服器實例的名稱,以查看其詳細資料。
Snapshot 成員 屬於群組成員的 Snapshot 數目。
建立日期 建立快照時的當地日期和時間。

按一下「設定」圖示 「設定」圖示,以顯示您可以新增至表格的選用欄位。

所有快照的可選資訊欄位列表
欄位 說明
建立者 它顯示 Snapshot 集是由使用者建立,還是由 備份原則 建立。
資源群組 一致性群組所隸屬的資源群組。
建立者 它會顯示 Snapshot 是由使用者建立,還是由 備份原則 建立。

透過按一下「動作」圖示 「動作」圖示,您可以顯示快速特定動作的功能表。

在主控台中檢視一致性群組的詳細資訊

若要查看一致性群組的詳細資訊,請在 VPC 清單的 Block Storage Snapshot 上找到該群組。 然後,按一下一致性群組的名稱。

概觀區段提供一致性群組及取得一致性群組 Snapshot 之虛擬伺服器實例的相關詳細資料。 第一個畫面包含一致性群組的相關資訊。

一致性組概述。
欄位 說明
名稱 一致性群組的唯一名稱。 如果您要更新它,請按一下 編輯圖示 「編輯」圖示
一致性群組 ID 此欄位顯示一致性群組的 ID 字串。
CRN 一致性群組的雲端資源名稱。
建立者 此欄位顯示 user (代表手動建立的 Snapshot) 或 備份原則 (代表自動 Snapshot)。
資源群組 一致性群組所隸屬的資源群組。
建立日期 它會顯示建立一致性群組的日期。
刪除 Snapshot 成員 它顯示在刪除一致性群組時是否刪除或保留 Snapshot。 按一下切換鍵以變更狀態。
地區 在其中建立一致性群組的 VPC 區域。

如需相關資訊,請參閱 管理 Snapshot 一致性群組

第二個畫面包含 Snapshot 集的來源磁區所連接之虛擬伺服器實例的相關資訊。

虛擬伺服器實例概述。
欄位 說明
名稱 虛擬伺服器執行個體的名稱。 按一下鏈結以移至實例的詳細資料頁面。
虛擬伺服器實例 ID 您可以複製要在其他介面 (例如 CLI、API 或 Terraform) 中使用的 ID。
虛擬專用雲端 在其中建立一致性群組的 VPC 名稱。 按一下鏈結以跳至 VPC 的詳細資料頁面。
影像 作業系統映像檔的相關資訊。
資源群組 虛擬伺服器實例所屬的資源群組。
標籤 用於虛擬伺服器實例的使用者定義標籤。

Snapshot 清單會顯示一致性群組內的 Snapshot,並提供 表 1 中所述的相同資訊及動作。

從命令列介面 (CLI) 檢視快照

您可以使用 CLI 來列出所有 Snapshot、磁區的所有 Snapshot,以及特定 Snapshot 的詳細資料。

開始之前

在使用 CLI 之前,您必須先安裝「IBM Cloud」CLI 以及 VPC CLI 外掛程式。 如需相關資訊,請參閱 CLI 必要條件

登入 IBM Cloud®。

ibmcloud login --sso -a cloud.ibm.com

此指令會傳回 URL 並提示輸入密碼。 在瀏覽器中移至該 URL 並登入。 如果成功,您將獲得一次性密碼。 複製此密碼並將其作為回應貼上到提示上。 成功鑑別之後,系統會提示您選擇帳戶。 如果您擁有多個帳戶,請選擇您要登入的帳戶。 回應任何剩餘提示以完成登入。

從 CLI 檢視地區中帳戶的所有 Snapshot

執行 snapshots 指令,以列出所有 Snapshot。 以下範例提供 us-south 區域中所有資源群組的所有快照清單。

ibmcloud is snapshots [--json]
Listing snapshots in all resource groups and region us-south under account Test Account as user test.user@ibm.com...
ID                                          Name             Status   Source volume                               Bootable   Resource group   Created                     Catalog Offering Version   Catalog Offering Plan   Storage Generation
r006-22db5609-69a1-4fe2-bd02-f64fb11230b3   my-test-snapshot stable   r006-ccbc5bc6-cd88-48e0-9a1d-de0f4d024324   true       defaults         2025-07-31T00:04:24+00:00   -                          -                       1
r006-e799fad8-aefa-4df5-81bd-dac6d13200a6   my-test-snap-1   stable   r006-2c5f577c-8cd0-47ef-8aec-cd8d1423249f   true       defaults         2025-08-06T22:38:01+00:00   -                          -                       1

如需可用 Snapshot 指令選項的相關資訊,請參閱 ibmcloud is snapshots

從 CLI 檢視磁區的所有 Snapshot

執行 snapshots 指令並指定磁區 ID。

ibmcloud is snapshots --volume VOLUME-ID [--json]

下列範例顯示磁區 r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa 取得的所有三個 Snapshot。

ibmcloud is snapshots --volume  r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa
Listing snapshots in all resource groups and region eu-de under account Test Account as user test.user@ibm.com...
ID                                          Name                             Status   Source volume                               Bootable   Resource group   Created
r138-7cac80af-63bb-4a1b-83dd-5f6d550a5db7   bear-peroxide-viewable-oxidant   stable   r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa   false      test-snap        2023-02-17T18:49:48+00:00
r138-4463eb2c-4913-43b1-b9bf-62a94f74c146   cli-snapshot-test                stable   r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa   false      defaults         2023-02-17T20:15:43+00:00
r138-e6664842-b370-496a-9ae7-da3fb647707c   snappy-snap-snap                 stable   r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa   false      test-snap        2023-02-17T18:53:57+00:00

如需可用指令選項的相關資訊,請參閱 ibmcloud is snapshots

從 CLI 檢視一致性群組中的所有 Snapshot

執行 snapshots 指令並指定一致性群組 ID、名稱或 CRN。

ibmcloud is snapshots --volume CONSISTENCY_GROUP_ID

下列範例使用一致性群組的 ID 來列出屬於該集的 Snapshot。

ibmcloud is snapshots --snapshot-consistency-group r174-7c8762e2-c1b9-424e-b773-23240d1780dd
Listing snapshots in all resource groups and region us-south under account Test Account as user test.user@ibm.com...
ID                                          Name            Status   Source volume                               Bootable   Resource group   Created
r174-b8cac978-a990-4824-a15c-604856982efe   snapshot-no-2   stable   r174-0641e516-09a1-4291-96ca-af254017123e   true       Default          2023-09-05T23:14:40+05:30
r174-7311f226-8259-46be-9bfa-5b2cd08bdf2f   snapshot-no-1   stable   r174-bf595773-9922-4dd4-9a3c-998b10022e0c   false      Default          2023-09-05T23:14:40+05:30

如需可用指令選項的相關資訊,請參閱 ibmcloud is snapshots

如需可用指令選項的相關資訊,請參閱 ibmcloud is snapshots

從 CLI 檢視 Snapshot 的詳細資料

執行 snapshot 指令,並指定快照 ID。

ibmcloud is snapshot SNAPSHOTS_ID [--json]

下列範例顯示 us-south 地區中可啟動 Snapshot 的詳細資料。

ibmcloud is snapshot r006-e799fad8-aefa-4df5-81bd-dac6d13200a6
Getting snapshot r006-e799fad8-aefa-4df5-81bd-dac6d13200a6 under account Test Account as user test.user@ibm.com...
ID                              r006-e799fad8-aefa-4df5-81bd-dac6d13200a6
Name                            my-test-snap-1
CRN                             crn:v1:bluemix:public:is:us-south:a/a1234567::snapshot:r006-e799fad8-aefa-4df5-81bd-dac6d13200a6
Status                          stable
Clones                          Zone   Available   Created
Source volume                   ID                                          Name               Remote Region   CRN                                                                                                                        Resource type
                                r006-2c5f577c-8cd0-47ef-8aec-cd8d1423249f   test-volume-fast   -               crn:v1:bluemix:public:is:us-south-1:a/a1234567::volume:r006-2c5f577c-8cd0-47ef-8aec-cd8d1423249f   volume
Backup policy plan              -
Snapshot Copies                 -
Bootable                        true
Encryption                      provider_managed
Encryption key                  -
Source Snapshot                 -
Minimum capacity(GB)            100
Size(GB)                        10
Source Image                    ID                                          Name                                 Remote Region   CRN                                                                                                                     Resource type
                                r006-cec640a3-615e-4364-bae7-d3642d9f9e34   ibm-ubuntu-22-04-5-minimal-amd64-4   -               crn:v1:bluemix:public:is:us-south:a/a1234567::image:r006-cec640a3-615e-4364-bae7-d3642d9f9e34   image
Operating system                Name                 Vendor      Version                                     Family         Architecture   Display name
                                ubuntu-22-04-amd64   Canonical   22.04 LTS Jammy Jellyfish Minimal Install   Ubuntu Linux   amd64          Ubuntu Linux 22.04 LTS Jammy Jellyfish Minimal Install (amd64)
Resource group                  ID                                 Name
                                6edefe513d934fdd872e78ee6a8e73ef   defaults
Created                         2025-08-06T22:38:01+00:00
Captured at                     2025-08-06T22:38:02+00:00
Tags                            -
Service Tags                    -
Storage Generation              1
Allowed Use API Version         2025-07-17
Allowed Use Bare Metal Server   true
Allowed Use Instance            true

allowed-used 屬性會在建立時從來源磁碟區或快照繼承。 您可以在建立時或之後變更它們的值,如果您被授權為 is.snapshot.snapshot.manage-allowed-use IAM 角色的話。 屬性包含一個 Boolean Common Expression Language 表達式。 當 instance 表達式的評估結果為 true 時,則允許使用快照配置虛擬伺服器實 例。 當評估表達式為 false 時,則會攔截佈建。 如果在建立時沒有指定值,則會從來源資源中取得約束表達式。

下列範例顯示 eu-de 地區中不可開機 Snapshot 的詳細資料,該地區在 eu-de-1 區域中也具有快速還原複本。

ibmcloud is snapshot r138-4463eb2c-4913-43b1-b9bf-62a94f74c146
Getting snapshot r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 under account Test Account as user test.user@ibm.com...
ID                         r138-4463eb2c-4913-43b1-b9bf-62a94f74c146
Name                       cli-snapshot-test
CRN                        crn:v1:bluemix:public:is:eu-de:a/a1234567::snapshot:r138-4463eb2c-4913-43b1-b9bf-62a94f74c146
Status                     stable
Clones                     Zone      Available   Created
                           eu-de-1   true        2023-02-17T20:15:46+00:00
Source volume              ID                                          Name
                           r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa   block-test1
Bootable                   false
Encryption                 provider_managed
Encryption key             -
Minimum capacity(GB)       20
Size(GB)                   1
Snapshot Consistency Group ID                                                    Name                    Snapshot Consistency Group ID                                         Name                                   CRN                                                                    Resource type
                           r174-4625d29b-3ac9-4bee-aca8-9366c4fd0c44 multiple-snapshots-consistency-group-1   crn:v1:bluemix:public:is:eu-de:a/a1234567:snapshot-consistency-group:r174-4625d29b-3ac9-4bee-aca8-9366c4fd0c44   snapshot_consistency_group
Resource group             ID                                 Name
                           6edefe513d934fdd872e78ee6a8e73ef   defaults
Created                    2023-12-05T20:15:43+00:00
Captured at                2023-12-05T20:15:44+00:00
Tags                       env:prod,env:test
Service Tags               -
Storage Generation         1

如需可用指令選項的相關資訊,請參閱 ibmcloud is snapshots

從 CLI 檢視所有快速還原 Snapshot 複本

您可以透過發出 ibmcloud is snapshot-clones 指令,列出 Snapshot 的所有可用的快速還原複本。 下列範例列出 ID 為 r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 之 Snapshot 的可用快速還原 Snapshot 複本。

ibmcloud is snapshot-clones r138-4463eb2c-4913-43b1-b9bf-62a94f74c146
Listing zonal clones of snapshot r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 under account Test Account as user test.user@ibm.com...
Zone      Available   Created
eu-de-1   true        2023-02-17T20:15:46+00:00
eu-de-3   true        2023-02-17T20:29:21+00:00

如需可用指令選項的相關資訊,請參閱 ibmcloud is snapshot-clones

從 CLI 檢視快速還原 Snapshot 複本的詳細資料

您可以執行 ibmcloud is snapshot-clone 指令,以列出特定快速還原 Snapshot 複本的詳細資料。 以下範例顯示如何列出 eu-de-3 區域中快照 r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 的快速還原快照複製的詳細資料。

ibmcloud is snapshot-clone r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 eu-de-3
Getting zonal clone eu-de-3 of snapshot r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 under account Test Account as user test.user@ibm.com...
Zone        eu-de-3
Available   true
Created     2023-02-17T20:29:21+00:00
Href        https://eu-de.iaas.cloud.ibm.com/v1/regions/eu-de/zones/eu-de-3

如需可用指令選項的相關資訊,請參閱 ibmcloud is snapshot-clone

從 CLI 檢視遠端區域 Snapshot 副本的詳細資料

您可以執行 ibmcloud is snapshot 指令,列出特定遠端區域快照複本的詳細資訊。 以下範例顯示如何列出 us-south 區域中的遠端區域快照 (my-cli-snapshot-crc) 的詳細資訊。 回應提供有關父快 照 (cli-snap-crc-test)、父磁碟區和建立快照的備份原則的資訊。

ibmcloud is snapshot my-cli-snapshot-crc
Getting snapshot my-cli-snapshot-crc-target under account Test Account as user test.user@ibm.com...
ID                     r006-8428038a-a399-4894-8c84-c8d7a4a75fae
Name                   my-cli-snapshot-crc
CRN                    crn:v1:bluemix:public:is:us-south:a/a1234567::snapshot:r006-8428038a-a399-4894-8c84-c8d7a4a75fae
Status                 stable
Clones                 Zone   Available   Created
Source volume          ID                                          Name                   Remote Region   CRN                                                                                                                       Resource type
                       r014-77ecae08-4a1e-4d15-94f0-814bfc1e108b   -remote-814bfc1e108b   us-east         crn:v1:bluemix:public:is:us-east-a/a1234567::volume:r014-77ecae08-4a1e-4d15-94f0-814bfc1e108b   volume
Backup policy plan     ID                                          Name                   Resource type
                       r014-d659eb15-ff07-4d54-8dd8-808a037e1b61   -remote-808a037e1b61   backup_policy_plan
Snapshot Copies        -
Bootable               false
Encryption             provider_managed
Encryption key         -
Source Snapshot        ID                                          Name                Remote Region   CRN                                                                                                                       Resource type
                       r014-1b960f89-e5f8-4323-ab81-ceaf15ea2a1c   cli-snap-crc-test   us-east         crn:v1:bluemix:public:is:us-east:a/a1234567::snapshot:r014-1b960f89-e5f8-4323-ab81-ceaf15ea2a1c   snapshot
Minimum capacity(GB)   100
Size(GB)               1
Source Image           -
Resource group         ID                                 Name
                       6edefe513d934fdd872e78ee6a8e73ef   defaults
Created                2024-06-18T17:21:24+00:00
Captured at            2024-06-18T17:21:20+00:00
Tags                   -
Service Tags           -
Storage Generation     1

從 CLI 檢視所有 Snapshot 一致性群組

執行 snapshot-consistency-groups 指令,以列出地區中的所有一致性群組。

ibmcloud is snapshot-consistency-groups

[新的] {: tag-green} 您也可以選擇根據備份工作 ID 篩選查詢結果。 當您需要透過還原來自兩個一致性群組的備份快照中的卷來還原實例時,依備份工作 ID 進行篩選會很有幫助;這種情況通常發生在原始實例同時掛載了第一代和第二代卷的情況下。

ibmcloud is snapshot-consistency-groups --backup-policy-job BACKUP_POLICY_JOB_ID

請參閱以下輸出範例:

Listing snapshot consistency groups in all resource groups and region us-south under account Test Account as user test.user@ibm.com...
ID                                      Name                           Backup policy job                      Backup policy plan                 Snapshots count   Lifecycle State   Service Tags                                               Resource group
r006-687c49cb-13ad-4dd8-9d04-0e264baa99a1  test-cli-2-4a3286e405b-4d3b  r006-8ebe4d1b-43e7-4371-abb9-aa0f27316b36  r006-ee0bddb-17b9-4279-8d1a-802afe9104da  1                 stable            is.instance:0726_98d1be09-e127-49f5-abe6-c1aa4181774d  Default
r006-7f5a3964-3528-4781-8bfe-df3dbb7d91cc  test-cli-2-f4690eb88143-441a  r006-8ebe4d1b-43e7-4371-abb9-aa0f27316b36  r006-ee0bddb-17b9-4279-8d1a-802afe9104da  2                 stable            is.instance:0726_98d1be09-e127-49f5-abe6-c1aa4181774d  Default

如需可用指令選項的相關資訊,請參閱 ibmcloud is snapshot-consistency-groups

從 CLI 檢視 Snapshot 一致性群組的詳細資料

執行 snapshot-consistency-group 指令,以列出地區中特定一致性群組的詳細資料。

ibmcloud is snapshot-consistency-group CONSISTENCY_GROUP_ID

[新的] {: tag-green} 範例輸出,顯示備份政策工作與計畫資訊:

Getting snapshot consistency group r006-7f5a3964-3528-4781-8bfe-df3dbb7d91cc under account Test Account as user test.user@ibm.com...
ID
r006-7f5a3964-3528-4781-8bfe-df3dbb7d91cc
Name
test-cli-2-f4690eb88143-441a
CRN
crn:v1:public:is:us-south:a/a1234567::snapshot-consistency-group:r006-7f5a3964-3528-4781-8bfe-df3dbb7d91cc
Href
https://us-south.iaas.cloud.ibm.com/v1/snapshot_consistency_groups/r006-7f5a3964-3528-4781-8bfe-df3dbb7d91cc
Status
stable
Backup policy job
ID                                   Resource type
r006-8ebe4d1b-43e7-4371-abb9-aa0f27316b36   backup_policy_job
Backup policy plan
ID                                   Name        Resource type
r006-ee0bddb-17b9-4279-8d1a-802afe9104da   test-cli-2   backup_policy_plan
Delete snapshot on delete
true
Source Snapshot
ID                                   Name                          Remote Region   CRN                                                                                                           Resource type
r006-7e672c73-b476-4ec6-94e9-b1ef498362aa   test-cli-2-c01a2ef47cd3-4202              crn:v1:public:is:us-south:a/a1234567::snapshot:r006-7e672c73-b476-4ec6-94e9-b1ef498362aa   snapshot
r006-388f4bb7-cdd2-4e60-b57e-690066412d45   test-cli-2-12524f129f23-4fbc              crn:v1:public:is:us-south:a/a1234567::snapshot:r006-388f4bb7-cdd2-4e60-b57e-690066412d45   snapshot
Resource group
ID                                   Name
11caaa983d9c4beb82690daadb08717e9     Default
Created
2026-05-05T21:42:30+05:30
Service Tags
is.instance:0726_98d1be09-e127-49f5-abe6-c1aa4181774d

有關可用指令選項的詳細資訊,請參閱 ibmcloud is snapshot-consistency-group.

使用 API 列出 Snapshot

您可以使用 API 來列出 Snapshot。

使用 API 列出所有 Snapshot

您可以透過在 VPC API 中呼叫 /snapshots 方法,以程式化方式列出磁區的所有 Snapshot,如下列範例要求中所示。 依預設,清單會先顯示最新的 Snapshot,然後以遞減順序顯示較舊的 Snapshot。

curl -X GET \
  "$vpc_api_endpoint/v1/snapshots?version=2022-12-16&generation=2" \
  -H "Authorization: Bearer $iam_token"

您可以使用資源群組 ID、來源磁區 ID 或來源磁區 CRN 來過濾清單,並使用下列選項來進一步過濾結果:

  • 限制-控制頁面上顯示的 Snapshot 數目。
  • 啟動-指定要啟動清單的 Snapshot (依 ID)。
  • 排序-控制頁面排序的順序,例如依建立日期或依 Snapshot 名稱按字母順序排序。

例如,下列呼叫會過濾清單以顯示針對單一磁區建立的 Snapshot,並將結果限制為每頁 5 個。

curl -X GET \
"$vpc_api_endpoint/v1/snapshots?version=2022-08-16&generation=2" \
-H "Authorization: Bearer $iam_token" \
-d '{
      "limit": 5,
      "source_volume":
        "id": "8948ad59-bc0f-7510-812f-5dc64f59fab8"
      }'

成功的回應如下例所示。

{
    "first": {
      "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshots?limit=50"
    },
    "limit": 5,
    "snapshots": [
      {
        "allowed_use": {
          "api_version": "2025-03-31",
          "bare_metal_server": "false",
          "instance": "gpu.count > 0 && gpu.manufacturer == 'nvidia'"
        },
        "bootable": true,
        "clones": [],
        "created_at": "2022-12-18T20:18:18Z",
        "crn": "crn:[...]",
        "deletable": true,
        "encryption": "user_managed",
        "encryption_key": {
          "crn": "crn:[...]"
        },
        "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshots/f945d446-0d46-478a-a298-acba907d45d1",
        "id": " f945d446-0d46-478a-a298-acba907d45d1",
        "lifecycle_state": "stable",
        "minimum_capacity": 100,
        "name": "my-snapshot",
        "operating_system": {
          "architecture": "amd64",
          "dedicated_host_only": false,
          "display_name": "Ubuntu Linux 20.04 LTS Focal Fossa Minimal Install (amd64)",
          "family": "Ubuntu Linux",
          "href": "https://us-south.iaas.cloud.ibm.com/v1/operating_systems/ubuntu-20-04-amd64",
          "name": "ubuntu-20-04-amd64",
          "vendor": "Canonical",
          "version": "20.04 LTS Focal Fossa Minimal Install"
        },
        "resource_group": {
          "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/678523bcbe2b4eada913d32640909956",
          "id": "678523bcbe2b4eada913d32640909956",
          "name": "Default"
        },
        "resource_type": "snapshot",
        "service_tags": [],
        "size": 1,
        "source_image": {
          "crn": "crn:[...]",
          "href": "https://us-south.iaas.cloud.ibm.com/v1/images/de066f7d-b95f-4ca2-9aa0-b6362889e933",
          "id": "de066f7d-b95f-4ca2-9aa0-b6362889e933",
          "name": "ubuntu-20-04-minimal-amd64-1"
        },
        "source_volume": {
          "crn": "crn:[...]",
          "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/8948ad59-bc0f-7510-812f-5dc64f59fab8",
          "id": "8948ad59-bc0f-7510-812f-5dc64f59fab8",
          "name": "instance-vol1"
        },
        "storage_generation": 1,
        "user_tags": []
      },
      {
        "allowed_use": {
          "api_version": "2025-03-31",
          "bare_metal_server": "false",
          "instance": "gpu.count > 0 && gpu.manufacturer == 'nvidia'"
        },
        "bootable": true,
        "clones": [],
        "created_at": "2022-12-17T20:11:28Z",
        "crn": "crn:[...]",
        "deletable": true,
        "encryption": "user_managed",
        "encryption_key": {
          "crn": "crn:[...]"
        },
        "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshots/e5bfa329-0e36-433f-a3bb-0df632e79263",
        "id": "e5bfa329-0e36-433f-a3bb-0df632e79263",
        "lifecycle_state": "stable",
        "minimum_capacity": 100,
        "name": "my-snapshot-2",
        "operating_system": {
          "architecture": "amd64",
          "dedicated_host_only": false,
          "display_name": "Ubuntu Linux 20.04 LTS Focal Fossa Minimal Install (amd64)",
          "family": "Ubuntu Linux",
          "href": "https://us-south.iaas.cloud.ibm.com/v1/operating_systems/ubuntu-20-04-amd64",
          "name": "ubuntu-20-04-amd64",
          "vendor": "Canonical",
          "version": "20.04 LTS Focal Fossa Minimal Install"
        },
        "resource_group": {
          "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/678523bcbe2b4eada913d32640909956",
          "id": "678523bcbe2b4eada913d32640909956",
          "name": "Default"
        },
        "resource_type": "snapshot",
        "service_tags": [],
        "size": 1,
        "source_image": {
          "crn": "crn:[...]",
          "href": "https://us-south.iaas.cloud.ibm.com/v1/images/23045dc2-b463-4cda-b424-bc3dcf51dfbb",
          "id": "23045dc2-b463-4cda-b424-bc3dcf51dfbb",
          "name": "ubuntu-20-04-minimal-amd64-1"
        },
        "source_volume": {
          "crn": "crn:[...]",
          "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/8948ad59-bc0f-7510-812f-5dc64f59fab8",
          "id": "8948ad59-bc0f-7510-812f-5dc64f59fab8",
          "name": "instance-vol1"
        },
        "storage_generation": 1,
        "user_tags": []
      }
    ],
    "total_count": 2
  }

使用 API 列出 Snapshot 的詳細資料

您可以透過在 VPC API 中呼叫 /snapshots 方法並指定 Snapshot ID,以程式化方式擷取單一 Snapshot 的詳細資料,如下列範例要求中所示。

curl -X GET \
"$vpc_api_endpoint/v1/snapshots/7528eb61-bc01-4763-a67a-a414a103f96d?version=2022-12-16&generation=2" \
-H "Authorization: Bearer $iam_token"

成功的回應如下例所示。

{
  "allowed_use": {
    "api_version": "2025-03-31",
    "instance": "gpu.count >= 2 && gpu.model in ['h100', 'a100'] && gpu.memory > 16 && enable_secure_boot == true",
    "bare_metal_server": "false"
  },
  "bootable": true,
  "clones": [],
  "captured_at": "2022-12-16T20:19:12Z",
  "created_at": "2021-12-16T20:18:18Z",
  "crn": "crn:[...]",
  "deletable": true,
  "encryption": "user_managed",
  "encryption_key": {
    "crn": "crn:[...]"
  },
  "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshots/7528eb61-bc01-4763-a67a-a414a103f96d",
  "id": "7528eb61-bc01-4763-a67a-a414a103f96d",
  "lifecycle_state": "stable",
  "minimum_capacity": 100,
  "name": "my-snapshot",
  "operating_system": {
    "architecture": "amd64",
    "dedicated_host_only": false,
    "display_name": "Ubuntu Linux 20.04 LTS Focal Fossa Minimal Install (amd64)",
    "family": "Ubuntu Linux",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/operating_systems/ubuntu-20-04-amd64",
    "name": "ubuntu-20-04-amd64",
    "vendor": "Canonical",
    "version": "20.04 LTS Focal Fossa Minimal Install"
  },
  "resource_group": {
    "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/59ff2d74-b0e5-4b40-a553-b812e50c72e9",
    "id": "59ff2d74-b0e5-4b40-a553-b812e50c72e9",
    "name": "Default"
  },
  "resource_type": "snapshot",
  "service_tags": [],
  "size": 1,
  "source_image": {
    "crn": "crn:[...]",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/images/dc021ec6-759d-4b87-8e0a-04106b8aa635",
    "id": "dc021ec6-759d-4b87-8e0a-04106b8aa635",
    "name": "ubuntu-20-04-minimal-amd64-1"
  },
  "source_volume": {
    "crn": "crn:[...]",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/c90453a6-7b5e-47ce-95fc-f6fff9e5b79c",
    "id": "c90453a6-7b5e-47ce-95fc-f6fff9e5b79c",
    "name": "my-instance-data"
  },
  "storage_generation": 1,
  "user_tags": []
}
  • allowed-used 屬性會在建立時從來源磁碟區或快照繼承。 您可以在建立時或之後變更它們的值,如果您被授權為 is.snapshot.snapshot.manage-allowed-use IAM 角色的話。 屬性包含一個 Boolean Common Expression Language 表達式。 當 instance 表達式的評估結果為 true 時,則允許使用快照配置虛擬伺服器實 例。 當評估表達式為 false 時,則會攔截佈建。 如果在建立時沒有指定值,則會從來源資源中取得約束表達式。

使用 API 檢視所有快速還原 Snapshot 複本

您可以透過在 VPC API 中呼叫 /snapshots/clones 方法並指定 Snapshot ID,以程式化方式列出所有快速還原複本,如下列範例要求中所示。

提出 GET /v1/snapshots/{id}/clones 要求,以列出所有快速還原 Snapshot 複本。

curl -X GET \
"$vpc_api_endpoint/v1/snapshots/7528eb61-bc01-4763-a67a-a414a103f96d/clones?version=2022-12-16&generation=2" \
-H "Authorization: Bearer $iam_token"

成功的回應提供快速還原 Snapshot 複本的相關資訊。

{
  "clones": [
    {
      "available": true,
      "created_at": "2022-12-16T19:55:28.537Z",
      "zone": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-2",
        "name": "us-south-2"
      }
    },
    {
      "available": true,
      "created_at": "2022-12-16T19:58:22.337Z",
      "zone": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-3",
        "name": "us-south-3"
      }
    }
  ]
}

使用 API 檢視快速還原 Snapshot 複本的詳細資料

您可以透過在 VPC API 中呼叫 /snapshots/clones 方法,並指定 Snapshot ID 及區域,以程式化方式擷取單一快速還原複本的詳細資料,如下列範例要求所示。

提出 GET /v1/snapshots/{id}/clones/{zone-name} 要求,以擷取 ID 和區域名稱指定的單一快速還原 Snapshot 複本。

curl -X GET \
"$vpc_api_endpoint/v1/snapshots/7528eb61-bc01-4763-a67a-a414a103f96d/clones/us-south-1?version=2022-12-16&generation=2" \
-H "Authorization: Bearer $iam_token"

成功回應會顯示快速還原 Snapshot 複本的下列相關資訊。

{
  "available": true,
  "created_at": "2022-12-16T20:15:35.164Z",
  "zone": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
    "name": "us-south-1"
  }
}

使用 API 檢視遠端區域 Snapshot 副本的詳細資料

您可以透過在 VPC API 中呼叫 /snapshots 方法並指定 Snapshot ID,以程式化方式擷取單一 Snapshot 的詳細資料,如下列範例要求中所示。

curl -X GET \
"$vpc_api_endpoint/v1/snapshots/7528eb61-bc01-4763-a67a-a414a103f96d?version=2022-12-16&generation=2" \
-H "Authorization: Bearer $iam_token"

成功回應會顯示類似下列範例的資訊。

{
  "allowed_use": {
    "api_version": "2025-03-31",
    "instance": "gpu.count >= 2 && gpu.model in ['h100', 'a100'] && gpu.memory > 16 && enable_secure_boot == true",
    "bare_metal_server": "false"
  },
  "bootable": true,
  "created_at": "2023-05-18T20:18:18Z",
  "crn": "crn:[...]",
  "deletable": false,
  "encryption": "user_managed",
  "encryption_key": {
    "crn": "crn:[...]"
  },
  "href": "https://us-east.iaas.cloud.ibm.com/v1/snapshots/r139-f6bfa329-0e36-433f-a3bb-0df632e79263",
  "id": "r139-f6bfa329-0e36-433f-a3bb-0df632e79263",
  "lifecycle_state": "stable",
  "minimum_capacity": 100,
  "name": "my-snapshot",
  "operating_system": {
    "architecture": "amd64",
    "dedicated_host_only": false,
    "display_name": "Ubuntu Linux 20.04 LTS Focal Fossa Minimal Install (amd64)",
    "family": "Ubuntu Linux",
    "gpu_supported": [],
    "href": "https://us-south.iaas.cloud.ibm.com/v1/operating_systems/ubuntu-20-04-amd64",
    "name": "ubuntu-20-04-amd64",
    "vendor": "Canonical",
    "version": "20.04 LTS Focal Fossa Minimal Install"
  },
  "resource_group": {
    "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/678523bcbe2b4eada913d32640909956",
    "id": "678523bcbe2b4eada913d32640909956",
    "name": "Default"
  },
  "resource_type": "snapshot",
  "service_tags": [],
  "region": "us-east",
  "size": 1,
  "source_image": {
    "crn": "crn:[...]",
    "remote": {
    	"region": {
    	   "name": "us-south",
    	   "hfef": "https://us-east.iaas.cloud.ibm.com/v1/regions/us-south"
    	}
    },
    "href": "https://us-south.iaas.cloud.ibm.com/v1/images/r006-32045dc2-b463-4cda-b424-bc3dcf51dfbb",
    "id": "r006-32045dc2-b463-4cda-b424-bc3dcf51dfbb",
    "name": "ibm-ubuntu-20-04-minimal-amd64-1"
  },
  "source_snapshot": {
    "crn": "crn:[...]",
    "remote": {
    	"region": {
    	   "name": "us-south",
    	   "hfef": "https://us-east.iaas.cloud.ibm.com/v1/regions/us-south"
    	}
    },
    "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshots/r006-511a798c-5816-4082-8ecb-554a440f83de",
    "id": "r006-511a798c-5816-4082-8ecb-554a440f83de",
    "name": "my-snapshot-data"
  },
  "source_volume": {
    "crn": "crn:[...]",
    "remote": {
    	"region": {
    	   "name": "us-south",
    	   "href": "https://us-east.iaas.cloud.ibm.com/v1/regions/us-south"
    	}
    },
    "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-411a798c-5816-4082-8ecb-554a440f83de",
    "id": "r006-411a798c-5816-4082-8ecb-554a440f83de",
    "name": "my-instance-data"
  },
  "storage_generation": 1,
  "user_tags": []
}

使用 API 檢視所有 Snapshot 一致性群組

您可以透過在 VPC API 中呼叫 /snapshot_consistency_groups 方法,以程式化方式列出所有一致性群組,如下列範例要求中所示。

curl -X GET "$vpc_api_endpoint/v1/snapshot_consistency_groups?version=2023-12-05&generation=2" \
-H "Authorization: Bearer $iam_token"

[新的] {: tag-green} 您也可以選擇根據備份工作 ID 篩選查詢結果。 當您需要透過還原來自兩個一致性群組的備份快照中的卷來還原實例時,依備份工作 ID 進行篩選會很有幫助;這種情況通常發生在原始實例同時掛載了第一代和第二代卷的情況下。

curl -X GET "$vpc_api_endpoint/v1/snapshot_consistency_groups/006-e8707243-96b3-4c27-be1f-57eff0196207?version=2023-12-05&generation=2" \
-H "Authorization: Bearer $iam_token"\
-d '{
      "backup_policy_job_id":
        "id": "8948ad59-bc0f-7510-812f-5dc64f59fab8"
      }'

使用 API 檢視 Snapshot 一致性群組的詳細資料

您可以透過在 VPC API 中呼叫 /snapshot_consistency_groups 方法,以程式化方式擷取一致性群組的詳細資料,如下列範例要求中所示。

curl -X GET "$vpc_api_endpoint/v1/snapshot_consistency_groups/006-e8707243-96b3-4c27-be1f-57eff0196207?version=2023-12-05&generation=2" \
-H "Authorization: Bearer $iam_token"

成功的回應如下例所示。

{
    "created_at": "2023-12-05T22:40:42Z",
    "id": "r006-e8707243-96b3-4c27-be1f-57eff0196207",
    "delete_snapshots_on_delete": true,
    "crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::snapshot-consistency-group:r006-e8707243-96b3-4c27-be1f-57eff0196207",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshot_consistency_groups/r006-e8707243-96b3-4c27-be1f-57eff0196207",
    "name": "my-consistency-group-snapshots",
    "resource_group": {
        "id": "a41ca701e1c041c1bb224564ff645770",
        "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/a41ca701e1c041c1bb224564ff645770",
        "name": "Default"
    },
    "lifecycle_state": "stable",
    "resource_type": "snapshot_consistency_group",
    "service_tags": [
        "is.instance:0727_44fda9fe-eeef-4e71-8fa4-4c3f7300e645"
    ],
    "snapshots": [
        {
            "crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::snapshot:r006-540d8d17-5334-4d04-b845-270dbb30233f",
            "id": "r006-540d8d17-5334-4d04-b845-270dbb30233f",
            "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshots/r006-540d8d17-5334-4d04-b845-270dbb30233f",
            "name": "my-test-scg-1",
            "resource_type": "snapshot"
        },
        {
            "crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::snapshot:r006-77cc526a-b21c-4bdc-a2b3-442a1d4e78c0",
            "id": "r006-77cc526a-b21c-4bdc-a2b3-442a1d4e78c0",
            "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshots/r006-77cc526a-b21c-4bdc-a2b3-442a1d4e78c0",
            "name": "my-test-scg-2",
            "resource_type": "snapshot"
        }
    ]
}

使用 Terraform 檢視 Snapshot

您可以使用 Terraform 來檢視 Snapshot。

要使用 Terraform,請下載 Terraform CLI 並設定 Provider IBM Cloud 外掛程式。 如需相關資訊,請參閱 Terraform 入門

VPC 基礎架構服務使用特定的地區端點,依預設會以 us-south 為目標。 如果您的 VPC 建立在另一個地區中,請確保將 provider.tf 檔案中提供者區塊中的適當地區設為目標。

請參閱下列以非預設 us-south 地區為目標的範例。

provider "ibm" {
  region = "eu-de"
}

使用 Terraform 列出所有 Snapshot

將 Snapshot 集合的詳細資料匯入為唯讀資料來源。 您可以依 source_volumeresource_groupname 等來過濾 Snapshot 集合。

data "ibm_is_snapshots" "example" {
}

如需相關資訊,請參閱 ibm_is_snapshots

使用 Terraform 列出 Snapshot 的詳細資料

將 Snapshot 的詳細資料匯入為唯讀資料來源。 您可以指定 Snapshot ID 或 Snapshot 名稱。

data "ibm_is_snapshot" "example" {
  identifier = "r138-e6664842-b370-496a-9ae7-da3fb647707c"
}
data "ibm_is_snapshot" "example" {
  name = "snappy-snap-snap"
}
  • allowed-used 屬性會在建立時從來源磁碟區或快照繼承。 您可以在建立時或之後變更它們的值,如果您被授權為 is.snapshot.snapshot.manage-allowed-use IAM 角色的話。 屬性包含一個 Boolean Common Expression Language 表達式。 當 instance 表達式的評估結果為 true 時,則允許使用快照配置虛擬伺服器實 例。 當評估表達式為 false 時,則會攔截佈建。 如果在建立時沒有指定值,則會從來源資源中取得約束表達式。

如需相關資訊,請參閱 ibm_is_snapshot

列出所有快速還原 Snapshot 複本

將 Snapshot 的所有快速還原複本的詳細資料匯入為唯讀資料來源。

data "ibm_is_snapshot_clones" "ds_snapshotclones" {
  snapshot = "r138-e6664842-b370-496a-9ae7-da3fb647707c"
}

如需相關資訊,請參閱 ibm_is_snapshot_clones

使用 Terraform 列出快速還原複本的詳細資料

將區域中 Snapshot 的快速還原複本的詳細資料匯入為唯讀資料來源。

data "ibm_is_snapshot_clone" "ds_snapshotclone" {
  snapshot = "r138-e6664842-b370-496a-9ae7-da3fb647707c"
  zone     = "eu-de-1"
}

如需相關資訊,請參閱 ibm_is_snapshot_clone

使用 Terraform 列出所有一致性群組

將一致性群組集合的詳細資料匯入為唯讀資料來源。

data "ibm_is_snapshot_consistency_groups" "example" {
}

如需相關資訊,請參閱 ibm_is_consistency_groups

使用 Terraform 列出一致性群組的詳細資料

將 Snapshot 一致性群組的詳細資料匯入為唯讀資料來源。 您可以依一致性群組的 ID 或名稱來指定一致性群組。

data "ibm_is_snapshot_consistency_group" "example 1" {
  identifier = ibm_is_snapshot_consistency_group.is_snapshot_consistency_group.id
}
data "ibm_is_snapshot_consistency_group" "example 2" {
  name = "my-data-consistency-group"
}

[新的] {: tag-green} 您也可以透過 backup_policy_job.id 屬性,將集合篩選為快照一致性群組。 請參閱下列範例。

data "ibm_is_snapshot_consistency_groups" "example 3" {
    backup_policy_job = "r006-fc4b7fbc-38af-45d9-9fb6-bf0533acbfc4"
}

如需相關資訊,請參閱 ibm_is_consistency_group

下一步

您可以修改或刪除 Snapshot,以及從 Snapshot 還原磁區。