管理 Block Storage for VPC Snapshot

透過重新命名、標記、啟用快速還原、刪除，以及驗證存取權限和狀態，來管理 Block Storage for VPC 快照。

命名 Snapshot

請考慮命名 Snapshot，以指出您所複製的磁區。例如，my-volume 會是 my-volume-snapshot1。此外，為了快速識別，請考量新增 boot 作為字首來命名開機磁區，例如 boot_my-volume-snapshot1。隨著 Snapshot 清單增長，您可以快速識別從中建立 Snapshot 的磁區名稱及類型。

Snapshot 名稱遵循與磁區名稱相同的需求。有效的名稱可以包含小寫字母、數字（a-z、0-9）以及連字號（-）的組合，長度最多為 63 個字元。 Snapshot 名稱必須以小寫字母開頭，且在 VPC 中必須是唯一的。使用者介面提供名稱檢查以方便使用。例如，如果您以連字號 (-) 作為 Snapshot 名稱的結尾，則使用者介面會通知您發生錯誤。它也會檢查是否有重複的名稱。

當您建立 Snapshot 的跨區域副本時，新的 Snapshot 會命名為 [copy]-[source-snapshot-name]。例如，當 snapshot-my-volume-snapshot1_ 的跨區域副本放在目標區域時，會自動命名為 copy-my-volume-snapshot1。 Snapshot 的跨區域副本與來源 Snapshot 及來源磁區無關，且副本可以像任何其他一般 Snapshot 一樣進行管理。

在控制台中重新命名快照

使用下列步驟在控制台中重新命名快照。

移至 Snapshot 清單。在 IBM Cloud控制台中，前往選單> 基礎架構> 儲存 > 快照。
從清單中按一下 Snapshot 的名稱。
按一下 編輯圖示 。
提供 Snapshot 的新名稱，儲存並確認您的變更。

從 CLI 重新命名 Snapshot

從 CLI 發出指令的必要條件

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

登入 IBM Cloud®。

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

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

從 CLI 重新命名 Snapshot

您可以從 CLI 重新命名 Snapshot。

若要重新命名 Snapshot，請發出 ibmcloud is snapshot-update 指令，並提供 Snapshot ID 及新名稱。

ibmcloud is snapshot-update SNAPSHOT_ID --name SNAPSHOT_NAME

請參閱下列範例。

ibmcloud is snapshot-update r138-e6664842-b370-496a-9ae7-da3fb647707c --name snappy-snap-snap

Updating snapshot r138-e6664842-b370-496a-9ae7-da3fb647707c under account Test Account as user test.user@ibm.com...

ID                     r138-e6664842-b370-496a-9ae7-da3fb647707c
Name                   snappy-snap-snap
CRN                    crn:v1:bluemix:public:is:eu-de:a/a1234567::snapshot:r138-e6664842-b370-496a-9ae7-da3fb647707c
Status                 stable
Clones                 Zone      Available   Created
                       eu-de-3   true        2023-02-17T20:28:53+00:00
                       eu-de-1   true        2023-02-17T18:53:57+00:00

Source volume          ID                                          Name
                       r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa   vicky-block-test1

Bootable               false
Encryption             provider_managed
Encryption key         -
Minimum capacity(GB)   20
Size(GB)               1
Resource group         ID                                 Name
                       a0eb5d9062af485fa5bb2c6999c74eac   test-snap

Created                2023-02-17T18:53:57+00:00
Captured at            2023-02-17T18:53:57+00:00
Tags                   -

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

從 CLI 變更快照的「允許使用」屬性

Allowed Use 屬性會從父卷繼承。您可以使用 ibmcloud is snapshot-update 指令來變更這些值。

您必須擁有 is.volume.volume.manage-allowed-use IAM 角色，才能變更快照的這些屬性。

ibmcloud is snapshot-update r006-b6b5e2ad-e60a-40c9-bbc2-356dad292fe3 --allowed-use-api-version "2025-03-03" --allowed-use-bare-metal-server "enable_secure_boot==true" --allowed-use-instance true

Updating snapshot r006-b6b5e2ad-e60a-40c9-bbc2-356dad292fe3 under account Test Account as user test.user@ibm.com...

ID                              r006-b6b5e2ad-e60a-40c9-bbc2-356dad292fe3
Name                            my-bootable-snapshot
CRN                             crn:v1:bluemix:public:is:us-south:a/a1234567::snapshot:r006-b6b5e2ad-e60a-40c9-bbc2-356dad292fe3
Status                          stable
Clones                          Zone   Available   Created

Source volume                   ID                                          Name                         Remote Region   CRN                                                                                                                        Resource type
                                r006-9a40241d-d116-4fc3-83ea-6134d30ee33c   fence-denture-mosaic-royal   -               crn:v1:bluemix:public:is:us-south-1:a/a1234567::volume:r006-9a40241d-d116-4fc3-83ea-6134d30ee33c   volume

Backup policy plan              -
Snapshot Copies                 -
Bootable                        true
Encryption                      provider_managed
Encryption key                  -
Source Snapshot                 -
Minimum capacity(GB)            100
Size(GB)                        1
Source Image                    ID                                          Name                                 Remote Region   CRN                                                                                                                     Resource type
                                r006-d734b459-b5a0-4777-8600-9fa3254d2cea   ibm-ubuntu-24-04-6-minimal-amd64-2   -               crn:v1:bluemix:public:is:us-south:a/a1234567::image:r006-d734b459-b5a0-4777-8600-9fa3254d2cea   image

Operating system                Name                 Vendor      Version                                  Family         Architecture   Display name
                                ubuntu-24-04-amd64   Canonical   24.04 LTS Noble Numbat Minimal Install   Ubuntu Linux   amd64          Ubuntu Linux 24.04 LTS Noble Numbat Minimal Install (amd64)

Resource group                  ID                                 Name
                                6edefe513d934fdd872e78ee6a8e73ef   defaults

Created                         2025-02-17T17:08:15+00:00
Captured at                     2025-02-17T17:08:15+00:00
Tags                            -
Service Tags                    -
Storage Generation              1
Allowed Use API Version         2025-03-03
Allowed Use Bare Metal Server   enable_secure_boot==true
Allowed Use Instance            true

屬性包含一個 Boolean Common Expression Language 表達式。當評估表達式為 true 時，則允許使用快照配置虛擬伺服器實例或裸機伺服器。當評估表達式為 false 時，則會攔截佈建。

使用 API 重新命名 Snapshot

您可以使用 API 來重新命名 Snapshot。

發出 PATCH /snapshots 呼叫，並指定 Snapshot ID 及 Snapshot 的新名稱。

curl -X PATCH \
"$vpc_api_endpoint/v1/snapshots/7528eb61-bc01-4763-a67a-a414a103f96d?version=2022-01-12&generation=2" \
   -H "Authorization: Bearer ${API_TOKEN}" \
   -d '{
     "name": "my-snapshot-renamed"
   }'

您可以使用相同的呼叫來重新命名跨區域副本。跨區域副本與來源 Snapshot 及來源磁區無關，且可以像任何其他 Snapshot 一樣進行管理。

使用 Terraform 更新 Snapshot

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

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

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

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

若要更新 Snapshot，請使用 ibm_is_snapshot 資源。您可以變更 Snapshot 名稱、快速還原區域及標籤。但是，變更 resource_group 和 source_volume 值會強制 Terraform 刪除快照並建立不同的快照。

resource "ibm_is_snapshot" "example" {
  name          = "my-snapshot"
  source_volume = ibm_is_volume.example.id
  }

如需引數及屬性的相關資訊，請參閱 ibm_is_snapshot。

在控制台中與另一個帳戶共用快照

您可以在控制台中與其他帳戶共用快照。

移至 Snapshot 清單。在 IBM Cloud控制台中，前往選單> 基礎架構> 儲存 > 快照。
從 “操作” 功能表中，選擇 “共用快照”。
輸入您要與其共用快照的帳戶的帳戶 ID。
按一下建立自訂 IAM 授權。

或者，您可以透過管理 > 存取 (IAM) > 授權功能表建立服務到服務授權。有關更多信息，請參閱在控制台中建立跨帳戶還原的服務間授權。

在控制台中管理快照的共用權限。

移至 Snapshot 清單。在 IBM Cloud控制台中，前往選單> 基礎架構> 儲存 > 快照。
從 「操作」 功能表中，選擇 「管理共用權限」。
側面板顯示您與之共享快照的帳戶清單。

該清單會顯示為快照設定的所有授權。例如，如果某個帳戶擁有對此特定快照的授權以及您帳戶中所有快照的授權，則該帳戶會列出兩次。
按一下 「管理IAM授權」，進入「授權」頁面，可修改或撤銷授權。

或者，您可以直接透過管理 > 存取 (IAM) > 授權選單管理服務到服務授權策略。如需相關資訊，請參閱使用授權來授與服務之間的存取權。

透過 CLI 與另一個帳戶共享快照

您可以使用 ibmcloud iam authorization-policy-create 命令從 CLI 為特定快照建立服務到服務授權。有關更多信息，請參閱從 CLI 建立跨帳戶恢復的服務到服務授權。

從 CLI 管理快照的共用權限

您可以使用 authorization-policy-delete 指令從 CLI 中刪除特定快照的服務到服務授權。有關更多信息，請參閱使用 CLI 刪除授權。

使用 API 與另一個帳戶共用快照

您可以透過呼叫 IAM 策略管理 API 中的 policies 方法以程式設計方式為特定快照建立服務到服務授權。有關更多信息，請參閱使用 API 建立跨帳戶恢復的服務間授權。

使用 API 管理快照的共用權限

您可以透過呼叫 IAM 策略管理 API 中的 policies 方法以程式方式撤銷特定快照的服務到服務授權。有關更多信息，請參閱使用 API 刪除授權。

在控制台中向快照新增標籤

您可以將使用者標籤及存取管理標籤新增至 Block Storage for VPC Snapshot。您可以將使用者標籤新增至現有 Snapshot，或在建立 Snapshot 時新增使用者標籤。備份原則可以使用標籤來建立 Snapshot 的備份。

從 Snapshot 清單畫面新增使用者標籤

請使用下列步驟，從 Snapshot 清單畫面新增使用者標籤。

移至 Snapshot 清單。
找到一個_可用的_創建的快照_使用者_。（由備份策略建立的快照被標識為由備份策略建立的_備份策略_.)
在標籤直欄中，具有標籤的 Snapshot 會顯示一個數字，指出已套用的標籤。沒有標籤的 Snapshot 具有 新增標籤 鏈結。按一下新增標籤。
在新視窗中，在使用者標籤文字框中鍵入標籤。
按一下儲存。

從 Snapshot 詳細資料頁面新增標籤

請使用下列步驟，從 Snapshot 詳細資料頁面新增標籤。

移至 Snapshot 清單。
按一下清單中 Snapshot 的名稱。
在 Snapshot 詳細資料頁面上，按一下 新增標籤 鏈結。
在新視窗中，在個別欄位中輸入使用者標籤或存取管理標籤。
按一下儲存。

當使用者標籤符合備份原則時，會根據備份計劃排程來觸發備份。如需相關資訊，請參閱建立備份原則。

從 CLI 將標籤新增至 Snapshot

您可以從 CLI 將標籤新增至 Snapshot。

指定 snapshot-update 指令並指定 --tags 選項，以將使用者標籤新增至磁區。

當您使用 ibmcloud is snapshot-create 建立 Snapshot 時，請使用相同的選項將標籤新增至磁區。

下列範例會將使用者標籤 env:test 和 env:prod 新增至由其 ID 識別的磁區。

ibmcloud is snapshot-update r138-e6664842-b370-496a-9ae7-da3fb647707c --name snappy-snap-snap --tags env:test,env:prod

Updating snapshot r138-e6664842-b370-496a-9ae7-da3fb647707c under account Test Account as user test.user@ibm.com...

ID                     r138-e6664842-b370-496a-9ae7-da3fb647707c
Name                   snappy-snap-snap
CRN                    crn:v1:bluemix:public:is:eu-de:a/a1234567::snapshot:r138-e6664842-b370-496a-9ae7-da3fb647707c
Status                 stable
Clones                 Zone      Available   Created
                       eu-de-3   true        2023-02-17T20:28:53+00:00
                       eu-de-1   true        2023-02-17T18:53:57+00:00

Source volume          ID                                          Name
                       r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa   vicky-block-test1

Bootable               false
Encryption             provider_managed
Encryption key         -
Minimum capacity(GB)   20
Size(GB)               1
Resource group         ID                                 Name
                       a0eb5d9062af485fa5bb2c6999c74eac   test-snap

Created                2023-02-17T18:53:57+00:00
Captured at            2023-02-17T18:53:57+00:00
Tags                   env:test,env:prod

當使用者標籤符合備份原則時，會根據備份計劃排程來觸發備份。如需相關資訊，請參閱建立備份原則。

使用 API 將使用者標籤新增至 Snapshot

您可以使用 API 將使用者標籤新增至 Snapshot。

發出 PATCH /snapshots 呼叫，並指定 Snapshot ID 和使用者標籤。下列範例會將使用者標籤 env:test 和 env:prod 新增至 Snapshot。

curl -X PATCH \
"$vpc_api_endpoint/v1/snapshots/7528eb61-bc01-4763-a67a-a414a103f96d?version=2022-01-12&generation=2" \
    -H "Authorization: Bearer ${API_TOKEN}" \
    -d `{
       "user_tags": [
         "env:test",
         "env:prod"
       ]
    }'

當使用者標籤符合備份原則時，會根據備份計劃排程來觸發備份。如需相關資訊，請參閱建立備份原則。

在控制台中編輯快速恢復區域

使用下列步驟編輯控制台中儲存快速恢復複製的區域。您可以視需要新增或移除區域。

從 Snapshot 清單中選取 Snapshot。
從動作功能表中，選取 編輯快速還原。
從側邊畫面中，選取或取消選取區域，以在您的地區中快速還原。根據您的選擇檢閱計費更新。
按一下儲存。您會回到 Snapshot 詳細資料頁面。「快速還原」區段會顯示最初具有擱置狀態的新區域。

當您重新整理時，會更新快速還原資訊。視您的變更而定，會更新區域資訊以顯示已啟用或已停用。

建立 Snapshot 複本以從 CLI 快速還原

若要建立 Snapshot 的區域副本，請使用 Snapshot ID 及您要建立副本的區域來發出 ibmcloud is snapshot-clone-create 指令。下列指令範例會在 eu-de-3 區域中建立 r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 的快速還原複本。

ibmcloud is snapshot-clone-create r138-4463eb2c-4913-43b1-b9bf-62a94f74c146  --zone eu-de-3

Creating zonal clone of snapshot r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 under account Test Account as user test.user@ibm.com...

Zone        eu-de-3
Available   false
Created     2023-02-17T20:29:21+00:00
Href        https://eu-de.iaas.cloud.ibm.com/v1/regions/eu-de/zones/eu-de-3

建立 Snapshot 複本時，Snapshot 複本似乎無法使用。只需要幾秒鐘。使用 Snapshot ID 及複製目標區域發出 ibmcloud is snapshot-cl 指令，以將新的 Snapshot 複本視為可用。

ibmcloud is snapshot-cl 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

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

從 CLI 刪除 Snapshot 複本

若要刪除 Snapshot 複本，請使用 Snapshot ID 及您要移除 Snapshot 副本的區域來發出 ibmcloud is snapshot-clone-delete 指令。下列指令範例會刪除 eu-de-3 區域中 Snapshot r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 的快速還原副本。

@$ ibmcloud is snapshot-clone-delete r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 eu-de-3
This will delete zonal clone eu-de-3 for snapshot r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 and cannot be undone. Continue [y/N] ?> y
Deleting zonal clone eu-de-3 for snapshot r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 under account Test Account as user test.user@ibm.com...
OK
Deletion request for zonal snapshot clone eu-de-3 has been accepted.

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

建立 Snapshot 複本以使用 API 進行快速還原

若要建立快速還原 Snapshot，您可以在不同區域中建立 Snapshot 的複本。然後從該複本還原磁區。

在 API 中，您可以透過發出 PUT /snapshots/{id}/clones/{zone_name} 呼叫來建立現有 Snapshot 的複本，以將 Snapshot 複製到指定的區域。請參閱下列範例。

curl -X PUT \
"$vpc_api_endpoint/v1/snapshots/5e160469-0837-48a7-8973-e44c8d5fd85a/clones/us-south-1&version=2025-02-18&generation=2" \
     -H "Authorization: Bearer ${API_TOKEN}"

成功的回應如下例所示。

{
  "available": true,
  "created_at": "2025-02-18T20:35:38.600Z",
  "zone": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
    "name": "us-south-1"
  },
  "storage_generation": 1,
}

您也可以在建立磁區的 Snapshot 時指定 clone 內容。請參閱下列範例。

curl -X POST \
"$vpc_api_endpoint/v1/snapshots?version=2025-02-18&generation=2" \
-H "Authorization: Bearer $iam_token" \
-d '{
    "clones": [{"zone": {"name": "us-south-1"}}],
    "name": "my-snapshot2",
    "resource_group": {"id": "a342dbfb-3ea7-48d1-96e8-2825ec5feab4"},
    "source_volume": {"id": "8948ad59-bc0f-7510-812f-5dc64f59fab8"},
    "user_tags": ["env:test","env:prod"]
   }'

成功的回應如下例所示。

{
  "bootable": false,
  "clones": [
      "available": true,
      "created_at": "2025-02-18T20:18:38.600Z",
      "zone": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
        "name": "us-south-1"
     }
  ],
  "created_at": "2025-02-18T20:18:18Z",
  "crn": "crn:[...]",
  "deletable": false,
  "encryption": "user_managed",
  "encryption_key": {
    "crn": "crn:[...]"
  },
  "storage_generation": 1
}

使用 API 刪除 Snapshot 複本

發出 DELETE /v1/snapshots/{id}/clones/{zone-name} 呼叫，以刪除指定區域中的 Snapshot 複本。當刪除 Snapshot 複本時，您無法復原刪除。

請參閱下列範例。

curl -X DELETE \
"$vpc_api_endpoint/v1/snapshots/fde0b8d5-2d75-4c28-af7d-12ffc3ae2a55/clones/us-south-1&version=2025-02-18&generation=2" \
     -H "Authorization: Bearer ${API_TOKEN}"

在控制台中建立遠端副本

使用下列步驟，從 VPC 的 Snapshot 清單或從 Snapshot 詳細資料頁面建立 Snapshot 的跨區域副本。

在控制台中，按一下導航選單圖示> 基礎架構> 儲存 >Block Storage快照。
在 Snapshot 清單中，尋找您要在另一個區域中複製的 Snapshot。確定快照處於 Stable 狀態。
按一下動作功能表，然後選擇複製快照。
請選擇您要建立副本的區域。

每個地區僅限擁有一份。如果沒有區域可供副本使用，則會停用複製 Snapshot 選項。
按一下建立。

或者，按一下 Snapshot 的名稱以檢視其詳細資料。您可以從 「操作」 功能表存取 「複製快照」 選項，也可以捲動至遠端副本卡並按一下「建立副本」。即會開啟相同的供應畫面，您可以在其中進行區域選擇。

在控制台中刪除遠端區域副本

遠端區域中的 Snapshot 副本與母項 Snapshot 和母項磁區無關。您隨時可以使用 VPC 的 Snapshot 清單來刪除它們。

使用下列步驟在控制台中刪除遠端區域副本。

在 IBM Cloud控制台中，前往選單> 基礎架構> 儲存 > 快照。
在您要刪除的 Snapshot 列中，按一下動作圖示。
選取刪除。
確認刪除，然後按一下刪除。

從 CLI 建立遠端區域副本

您可以使用 snapshot-create 指令並搭配 --source-snapshot-crn 選項及來源 Snapshot CRN，來建立 Snapshot 的跨區域副本，這會使用來源區域中 Snapshot 的 CRN，在目標區域中建立 Snapshot。如果同時指定加密金鑰的 CRN，則建立的 Snapshot 會使用客戶定義的加密金鑰。來源快照必須處於穩定狀態才能成功建立副本。

ibmcloud is snapshot-create --name my-cli-snapshot-crc --source-snapshot-crn crn:v1:bluemix:public:is:us-south:a/a1234567::snapshot:r006-b9590a48-63a3-445e-b819-3f2c0b82daf8

Creating snapshot my-cli-snapshot-crc under account Test Account as user test.user@ibm.com...

ID                     r142-bd4532c0-e73c-44f9-a017-89e5368c521a
Name                   my-cli-snapshot-crc
CRN                    crn:v1:bluemix:public:is:us-east:a/a1234567::snapshot:r142-bd4532c0-e73c-44f9-a017-89e5368c521a
Status                 pending
Clones                 Zone   Available   Created

Source volume          ID                                          Name                   Remote Region
                       r006-be21061a-4dc6-4c9f-b17d-421838fde399   -remote-421838fde399   us-south

Snapshot Copies        ID   Name   Remote Region   CRN   Resource type

Bootable               true
Encryption             provider_managed
Encryption key         -
Source Snapshot        ID                                          Name                   Remote Region   CRN                                                                                                                        Resource type
                       r006-b9590a48-63a3-445e-b819-3f2c0b82daf8   cli-snap-crc-test-sn   us-south        crn:v1:bluemix:public:is:us-south:a/a1234567::snapshot:r006-b9590a48-63a3-445e-b819-3f2c0b82daf8   snapshot

Minimum capacity(GB)   100
Size(GB)               1
Source Image           ID                                          Name                   Remote Region
                       r006-24d856e2-6aec-41c2-8f36-5a8a3766f0d6   -remote-5a8a3766f0d6   us-south

Operating system       Name             Vendor   Version                 Family   Architecture   Display name
                       centos-7-amd64   CentOS   7.x - Minimal Install   CentOS   amd64          CentOS 7.x - Minimal Install (amd64)

Resource group         ID                                 Name
                       cdc21b72d4e647b195de988b175e3d82   Default

Created                2023-04-24T18:54:29+05:30
Captured at            2023-04-24T09:48:03+05:30
Tags                   -
Service Tags           -

有關可用指令選項的詳細資訊，請參閱 ibmcloud is snapshot-create

從 CLI 刪除遠端地區副本

您可以搭配使用 ibmcloud is snapshot-delete 指令與 Snapshot ID，來刪除 Snapshot 的跨區域副本。

ibmcloud is snapshot-delete r142-bd4532c0-e73c-44f9-a017-89e5368c521a

This will delete snapshot r142-bd4532c0-e73c-44f9-a017-89e5368c521a and cannot be undone. Continue [y/N] ?> y
Deleting snapshot r142-bd4532c0-e73c-44f9-a017-89e5368c521a under account Test Account as user test.user@ibm.com...
    OK
Snapshot r142-bd4532c0-e73c-44f9-a017-89e5368c521a is deleted.

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

使用 API 建立遠端區域副本

您可以在目標地區中發出 API 呼叫來建立 Snapshot 的跨地區副本。指定來源快照的CRN以在目標區域建立副本。如果同時指定加密金鑰的 CRN，則建立的 Snapshot 會使用客戶定義的加密金鑰。來源快照必須處於穩定狀態才能成功建立副本。請參閱下列範例，其中目標地區是 us-east，而原始 Snapshot 位於 us-south。

POST https://us-east.iaas.cloud.ibm.com/v1/snapshots
{
     "name": "my-snapshot",    // required
     "source_snapshot": {      // required
      	"crn": "crn:[...]"
     },
     "resource_group": {       // optional
       "id": "2d1bb5a8-40a8-447a-acf7-0eadc8aeb054"
     },
     "encryption_key": "crn:[...]"     // optional
}

成功的回應如下例所示：

{
  "created_at": "2023-05-18T20:18:18Z",
  "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": "pending",
  "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": [],
  "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",
    	   "hfef": "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"
  },
  "user_tags": []
}

使用 API 刪除 Snapshot 的遠端區域副本

在遠端副本所在的目標區域中建立 DELETE /snapshots/{id}。

curl -X DELETE https://us-east.iaas.cloud.ibm.com/v1/snapshots/{id}

使用 Terraform 建立跨區域副本

若要在遠端區域中建立 Snapshot 副本，請使用 ibm_is_snapshot 資源。來源快照必須處於穩定狀態才能成功建立副本。如果同時指定加密金鑰的 CRN，則建立的 Snapshot 會使用客戶定義的加密金鑰。下列範例使用來源 Snapshot 的 ID 在目標區域中建立副本。副本將由其 CRN 指定的加密金鑰加密。

resource "ibm_is_snapshot" "snapshot" {
  name 		        = "my-cross-regional-snapshot"
  source_snapshot = "r138-4463eb2c-4913-43b1-b9bf-62a94f74c146"
  encryption_key  = "crn:bluemix:public:kms:us-south:a/df0564dd126042ebb03e0224728ce939:4957299d-0ba0-487f-a1a0-c724a729b8b4:key:0cb88b98-9261-4d07-8329-8f594b6641b5"
}

如需引數及屬性的相關資訊，請參閱 ibm_is_snapshot。

使用 Terraform 刪除遠端區域副本

使用 terraform destroy 指令可方便地刪除遠端物件，例如快照的跨區域複本。下列範例顯示刪除 Snapshot 的語法。替換 ibm_is_snapshot.example.id 中 Snapshot 的實際 ID。

terraform destroy --target ibm_is_snapshot.example.id

如需相關資訊，請參閱 terraform destroy。

在控制台中刪除快照

您可以刪除磁區的任何 Snapshot 或磁區的所有 Snapshot。若要能夠刪除 Snapshot，它必須符合下列必要條件:

處於 stable 或 pending 狀態。
不主動還原磁區。

確定是否可以刪除快照的方便方法是在主控台中尋找快照清單，並檢查其狀態。您可以刪除磁區的所有 Snapshot。刪除所有快照需要在控制台中進一步確認。

在控制台中刪除單一快照

您可以使用下列步驟，從所有 Snapshot 清單中刪除 Snapshot。

移至所有 Snapshot 的清單。在 IBM Cloud控制台中，前往選單> 基礎架構> 儲存 > 快照。
在您要刪除的 Snapshot 列中，按一下動作圖示。
選取刪除。
確認刪除，然後按一下刪除。

您也可以從 Block Storage for VPC 磁區的詳細資料頁面中刪除 Snapshot。

移至所有 Block Storage for VPC 磁區的清單。在 IBM Cloud控制台中，按一下導航選單圖示> 基礎架構> 儲存 >Block Storage區。
從清單中選取磁區，然後按一下磁區名稱以移至磁區詳細資料頁面。
按一下 Snapshot。即會顯示針對此磁區所取得的 Snapshot 清單，您可以採取下列動作:
- 按一下 全部刪除，以刪除此磁區的所有 Snapshot。
- 按一下動作圖示，以刪除特定 Snapshot。
選取刪除。如果 Snapshot 正在主動還原磁區，則刪除作業無法運作。
確認刪除。

在控制台中刪除磁碟區的所有快照

若要在控制台中刪除磁碟區的所有快照，請依照下列步驟操作。

移至所有 Snapshot 的清單。在 IBM Cloud控制台中，前往選單> 基礎架構> 儲存 > 快照。
按一下列以選取您要刪除的 Snapshot。
從動作功能表中，選取 刪除磁區的全部。
輸入 delete 以確認刪除，然後按一下刪除。

刪除快照Block Storage for VPC控制台中的詳細資訊頁面

您可以從 Block Storage for VPC 磁區詳細資料頁面中，從 Snapshot 清單中刪除最近建立的 Snapshot。您可以選擇性地從此視圖中刪除所有 Snapshot。

移至所有 Block Storage for VPC 磁區的清單。在 IBM Cloud控制台中，前往選單> 基礎架構> 儲存 >Block Storage區。
從清單中選取磁區，然後按一下磁區名稱以移至磁區詳細資料頁面。
按一下 Snapshot，以查看針對此磁區所取得的 Snapshot 清單。
按一下 全部刪除，以刪除此磁區的所有 Snapshot。
或者，在清單中選取要刪除的單一 Snapshot，然後:
1. 按一下動作圖示。
2. 選取刪除。
3. 確認刪除。

從 CLI 刪除 Snapshot

您可以刪除磁區的任何 Snapshot 或磁區的所有 Snapshot。若要能夠刪除 Snapshot，它必須符合下列必要條件:

處於 stable 或 pending 狀態。
不主動還原磁區。

從 CLI 刪除單一 Snapshot

請使用 CLI 來執行下列步驟，以刪除單一 Snapshot。

列出可供磁區使用的 Snapshot，以確認您要刪除的 Snapshot ID。

ibmcloud is snapshots --volume VOLUME [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME]

$ 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

執行 snapshot-delete 指令並指定 Snapshot 的 ID。若要刪除多個 Snapshot，您必須在相同的指令中指定其所有 ID。
```
ibmcloud is snapshot-delete SNAPSHOT_ID
```

請確認刪除快照。回應訊息指出已刪除 Snapshot。

$ ibmcloud is snapshot-delete r138-e6664842-b370-496a-9ae7-da3fb647707c
This will delete snapshot r138-e6664842-b370-496a-9ae7-da3fb647707c and cannot be undone. Continue [y/N] ?> y
Deleting snapshot r138-e6664842-b370-496a-9ae7-da3fb647707c under account Test Account as user test.user@ibm.com...
OK
Snapshot r138-e6664842-b370-496a-9ae7-da3fb647707c is deleted.

如需可用指令選項的相關資訊，請參閱 ibmcloud is snaphot-delete。

從 CLI 刪除所有 Snapshot

請使用 CLI 來執行下列步驟，以刪除所有 Snapshot。

列出所有 Snapshot。

ibmcloud is snapshots --volume VOLUME [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME | --all-resource-groups]

輸入 snapshots-delete 指令並指定磁區 ID。

ibmcloud is snapshots-delete --volume VOLUME_ID

請確認刪除快照。回應訊息指出何時接受 Snapshot 刪除要求，以及何時刪除 Snapshot。

$ ibmcloud is snapshots-delete --volume  r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa
This will delete snapshot by volume r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa and cannot be undone. Continue [y/N] ?> y
Deleting snapshot by volume r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa under account Test Account as user test.user@ibm.com...
OK
Deletion request for snapshots by volume r010-df8ffd90-f2e5-470b-83d7-76e64995a1aa has been accepted.

如需可用指令選項的相關資訊，請參閱 ibmcloud is snaphot-delete。

使用 API 刪除快照

您可以刪除磁區的任何 Snapshot 或磁區的所有 Snapshot。若要能夠刪除 Snapshot，它必須符合下列必要條件:

處於 stable 或 pending 狀態。
不主動還原磁區。

使用 API 刪除單一 Snapshot

發出 DELETE /snapshots/{snapshot_ID} 呼叫，依 ID 刪除特定 Snapshot。

curl -X DELETE \
"$vpc_api_endpoint/v1/snapshots/7528eb61-bc01-4763-a67a-a414a103f96d?version=2022-12-22&generation=2" \
     -H "Authorization: Bearer ${API_TOKEN}"

使用 API 刪除磁區的所有 Snapshot

發出 DELETE/snapshots 呼叫，並在要求中指定 source_volume.id 參數的來源磁區 ID。

curl -X DELETE \
"$vpc_api_endpoint/v1/snapshots?source_volume.id=_volume-id_&version=2022-12-22&generation=2" \
     -H "Authorization: Bearer ${API_TOKEN}"

使用 Terraform 刪除 Snapshot

您可以刪除磁區的任何 Snapshot 或磁區的所有 Snapshot。若要能夠刪除 Snapshot，它必須符合下列必要條件:

處於 stable 或 pending 狀態。
不主動還原磁區。

使用 Terraform 刪除單一 Snapshot

使用 terraform destroy 指令可方便地刪除遠端物件，例如單一快照。下列範例會刪除 my-snapshot。

terraform destroy --target ibm_is_snapshot.my-snapshot

如需相關資訊，請參閱 terraform destroy。

使用 Terraform 刪除磁區的所有 Snapshot

若要刪除具有 Terraform 之磁區的所有 Snapshot，請使用 ibm_is_volume 資源。

resource "ibm_is_volume" "storage" {
  name                 = "example-volume"
  profile              = "general-purpose"
  zone                 = "us-south-1"
  delete_all_snapshots = true
}

如需引數及屬性的相關資訊，請參閱 ibm_is_volume。

監控快照生命週期狀態

表 2 說明 Snapshot 生命週期中的 Snapshot 狀態。您可以在主控台、CLI 的命令輸出、API 回應和 Terraform 資料來源中看到這些狀態。

快照生命週期狀態
Snapshot 狀態	說明
穩定	Snapshot 可用於還原磁區。
等待中	正在擷取 Snapshot 資訊。
擱置	建立 Snapshot 時，會顯示已完成百分比。
Failed	建立快照失敗，無法從快照還原磁碟區。
已暫停	Snapshot 暫時無法使用。
更新	您已變更 Snapshot 的相關內容，且正在更新它。
正在刪除	快照正在被刪除。
已刪除	Snapshot 已刪除，無法用於還原磁區。

下一步

您可以從 Snapshot 還原磁區。