檢視 Block Storage for VPC Snapshot 及一致性群組
檢視 Block Storage for VPC 的快照與一致性群組,包括各快照及其屬性的詳細資訊。
在主控台中列出快照
您可以使用使用者介面來列出 Snapshot 及一致性群組。
在主控台中列出所有快照
在主控台中,您可以檢視您建立的所有 Snapshot 的清單,最新的 Snapshot 位於清單的開頭。 您可以過濾清單以檢視特定 Snapshot。
-
在 IBM Cloud控制台中,按一下導航選單圖示
> 基礎架構
> 儲存 > VPC 的Block Storage快照。 頁面有兩個主要標籤: Snapshot 一致性群組和 Snapshot。
-
選取「快照」索引標籤。 會列出特定區域的 Snapshot。 如果您想要查看另一個區域中的 Snapshot,請按一下箭頭來展開清單並選取不同的區域。 依預設,最新的 Snapshot 會顯示在清單開頭。
-
隨著 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 ID | Snapshot 的可複製 GUID。 |
| 可開機 | 是或否。 |
| CRN | Snapshot 的可複製 CRN。 |
| 資源群組 | 設定 VPC 時所定義的資源群組。 |
| 建立日期 | Snapshot 資源建立程序開始的日期和時間。 |
| 擷取日期 | 擷取此 Snapshot 的日期和時間。 |
| 建立者 | 此欄位顯示 User 或 Backup policy。 如果 Snapshot 是由備份原則所建立,使用者介面也會顯示建立備份 Snapshot 之備份計劃的名稱。 |
| 大小 | Snapshot 的大小 (GB),繼承自來源磁區。 |
| 來源磁區 | 從中取得第一個 Snapshot 的來源磁區。 按一下鏈結以取得磁區詳細資料。 如果已刪除磁區,則會出現沒有鏈結的名稱。 |
| 加密 | 提供者管理或客戶管理的加密。 對於客戶管理的加密,會顯示 KMS 實例、主要金鑰名稱及主要金鑰 ID。 |
| 世代 | 根據來源磁碟區的磁碟區配置文件,此值為 Gen 1 或 Gen 2。 |
| 虛擬伺服器表示式 | 允許使用表達式定義並限制可開機快照與哪些虛擬伺服器設定檔相容。 當您使用快照配置虛擬伺服器實體時,表達式會與要求的實體屬性進行比對。 如需詳細資訊,請參閱 在自訂影像中加入允許使用的表達式。 |
| 快速還原畫面 | 使用 快速還原,從這個完全供應的 Snapshot 建立磁區。 按一下 編輯,以在區域中 啟用或停用快速還原。 |
| 一致性群組畫面 | 它會顯示 Snapshot 所屬一致性群組的相關資訊。 按一下 建立虛擬伺服器,以從一致性群組還原磁區。 |
透過按一下「動作」圖示 ,您可以顯示快速特定動作的功能表。
- 從 Snapshot 建立磁區
- 編輯快速還原,或刪除 Snapshot。
在主控台中列出所有快照的一致性群組
在主控台中,您可以檢視您所建立的所有一致性群組的清單,最新的一致性群組位於清單的開頭。 您可以過濾清單以檢視特定的一致性群組。
-
在 IBM Cloud控制台中,按一下導航選單圖示
> 基礎架構
> 儲存 > VPC 的Block Storage快照。 頁面有兩個主要標籤: Snapshot 一致性群組和 Snapshot。
-
選取 Snapshot 一致性群組 標籤。 會列出特定地區的群組。 如果您想要查看另一個區域中的一致性群組,請按一下箭頭來展開清單,並選取不同的區域。 依預設,最新的 Snapshot 群組會顯示在清單的開頭。
-
隨著一致性群組清單的增長,請使用過濾器來指出每頁要顯示的項目數。 使用頁面導覽箭頭在清單中向前及向後移動。
下表說明清單中所有一致性群組的資訊。
| 欄位 | 說明 |
|---|---|
| 名稱 | 您建立一致性群組時所提供的名稱。 按一下群組名稱以查看其 詳細資料。 |
| 狀態 | 一致性群組的狀態,視它是可用 (作用中 狀態)、無法使用或正在建立而定。 |
| 來源 VSI | 它顯示包含一致性群組中 Snapshot 的來源磁區的虛擬伺服器實例。 按一下虛擬伺服器實例的名稱,以查看其詳細資料。 |
| Snapshot 成員 | 屬於群組成員的 Snapshot 數目。 |
| 建立日期 | 建立快照時的當地日期和時間。 |
按一下「設定」圖示 ,以顯示您可以新增至表格的選用欄位。
| 欄位 | 說明 |
|---|---|
| 建立者 | 它顯示 Snapshot 集是由使用者建立,還是由 備份原則 建立。 |
| 資源群組 | 一致性群組所隸屬的資源群組。 |
| 建立者 | 它會顯示 Snapshot 是由使用者建立,還是由 備份原則 建立。 |
透過按一下「動作」圖示 ,您可以顯示快速特定動作的功能表。
- 重新命名
- 複製 UUID
- 複製雲端資源名稱 (CRN)。
- 建立虛擬伺服器
- 刪除
在主控台中檢視一致性群組的詳細資訊
若要查看一致性群組的詳細資訊,請在 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-useIAM 角色的話。 屬性包含一個 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_volume、resource_group、name 等來過濾 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-useIAM 角色的話。 屬性包含一個 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 還原磁區。