管理 Block Storage for VPC 快照

您可以通过多种方式管理现有快照。重命名现有快照以使其更易于识别。将用户标记添加到快照以供 VPC 备份服务使用。启用禁用快照的快速复原副本。删除不再需要的快照，并为新快照释放空间。验证 Cloud Identity and Access Management 访问权。验证快照状态。

命名快照

请考虑对快照进行命名以指示复制的卷。例如，my-volume 将为 my-volume-snapshot1。此外，为了快速识别，请考虑通过添加 boot 作为前缀来命名引导卷，例如 boot_my-volume-snapshot1。随着快照列表的增长，您可以快速识别从中创建快照的卷的名称和类型。

快照名称遵循与卷名称相同的需求。有效名称可包括小写字母数字字符（a-z，0-9）和连字符（-）的组合，最多 63 个字符。快照名称必须以小写字母开头，并且必须在 VPC 中唯一。为了方便起见，UI 提供了名称检查。例如，如果以连字符 (-) 结束快照名称，那么 UI 会通知您该错误。它还会检查重复的名称。

创建快照的跨区域副本时，新快照将命名为 [copy]-[source-snapshot-name]。例如，snapshot-my-volume-snapshot1_ 的跨区域副本在放置在目标区域中时自动命名为 copy-my-volume-snapshot1。快照的跨区域副本独立于源快照和源卷，这些副本可以像任何其他常规快照一样进行管理。

在控制台中重命名快照

使用以下步骤在控制台中重命名快照。

转至快照列表。在 IBM Cloud 控制台中，转到菜单 > 基础架构 > 存储 > 快照。
单击列表中快照的名称。
单击 编辑图标 。
为快照提供新名称，保存并确认更改。

从 CLI 重命名快照

从 CLI 发出命令的先决条件

在使用 CLI 之前，您必须安装 IBM Cloud CLI 和 VPC CLI 插件。有关更多信息，请参阅 CLI 先决条件。

登录到 IBM Cloud®。

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

此命令会返回 URL 并提示输入密码。在浏览器中转至该 URL 并登录。如果成功，您将获得一次性密码。复制此密码并将其作为响应粘贴到提示上。成功认证后，系统会提示您选择帐户。如果可以访问多个账户，请选择要登录的账户。响应任何剩余提示以完成登录。

从 CLI 重命名快照

您可以从 CLI 重命名快照。

要重命名快照，请发出 ibmcloud is snapshot-update 命令并提供快照标识和新名称。

ibmcloud is snapshot-update SNAPSHOT_ID --name SNAPSHOT_NAME

请参阅以下示例。

cloudshell:~$ 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。

使用 API 重命名快照

您可以使用 API 重命名快照。

发出 PATCH /snapshots 调用并指定快照的快照标识和新名称。

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"
   }'

您可以使用同一调用来重命名跨区域副本。跨区域拷贝独立于源快照和源卷，并且可以像任何其他快照一样进行管理。

使用 Terraform 更新快照

要使用 Terraform，请下载 Terraform CLI 并配置 IBM Cloud 提供者插件。有关更多信息，请参阅 Terraform 入门。

VPC 基础架构服务使用特定区域端点，缺省情况下该端点以 us-south 为目标。如果 VPC 是在另一个区域中创建的，请确保将 provider.tf 文件中的提供程序块中的相应区域作为目标。

请参阅以下以非缺省 us-south 区域为目标的示例。

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

要更新快照，请使用 ibm_is_snapshot 资源。您可以更改快照的名称，快速复原区域和标记。然而，如果修改 resource_group 和 source_volume 的值，Terraform将不得不删除快照并创建另一个快照。

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

有关自变量和属性的更多信息，请参阅 ibm_is_snapshot。

在控制台中与另一个账户共享快照

您可以在控制台中与另一个账户共享快照。

转至快照列表。在 IBM Cloud 控制台中，转到菜单 > 基础架构 > 存储 > 快照。
从 Actions 菜单中，选择 共享快照。
输入要与之共享快照的账户 ID。
单击 创建自定义 IAM 授权。

或者，也可以通过 Manage > Access (IAM) > Authorizations 菜单创建服务对服务授权。有关详细信息，请参阅在控制台中为跨账户还原创建服务对服务授权。

在控制台中管理快照的共享权限。

转至快照列表。在 IBM Cloud 控制台中，转到菜单 > 基础架构 > 存储 > 快照。
从 Actions 菜单中，选择 管理共享权限。
侧边面板显示与您共享快照的账户列表。

列表显示为快照设置的所有授权。例如，如果某个账户拥有对该特定快照的授权和对您账户中所有快照的授权，则该账户会被列出两次。
单击 Manage IAM Authorization（管理 IAM 授权） 转到授权页面以修改或撤销授权。

或者，您也可以直接通过 Manage > Access (IAM) > Authorizations 菜单管理服务间授权策略。有关更多信息，请参阅使用授权来授予服务之间的访问权。

通过 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 快照。您可以向现有快照添加用户标记，也可以在创建快照时添加用户标记。这些标记可由备份策略用于创建快照的备份。

从快照列表屏幕添加用户标记

使用以下步骤从快照列表屏幕添加用户标记。

转至快照列表。
查找由 _ 用户_创建的 _ 可用_快照。 (由备份策略创建的快照被标识为由 _ 备份策略_创建）
在标记列中，带有标记的快照会显示一个数字，指示已应用的标记。没有标记的快照具有 添加标记 链接。单击添加标记。
在新窗口中，在“用户标记”文本框中输入标记。
单击保存。

从快照详细信息页面添加标记

使用以下步骤从快照详细信息页面添加标记。

转至快照列表。
单击列表中快照的名称。
在快照详细信息页面上，单击 添加标记 链接。
在新窗口中，在相应的字段中输入用户标记或访问管理标记。
单击保存。

当用户标记与备份策略匹配时，将根据备份计划调度触发备份。有关更多信息，请参阅创建备份策略。

从 CLI 向快照添加标记

您可以从 CLI 向快照添加标记。

指定带有 --tags 选项的 snapshot-update 命令，以向卷添加用户标记。

使用同一选项在使用 ibmcloud is snapshot-create 创建快照时向卷添加标记。

以下示例将用户标记 env:test 和 env:prod 添加到由其标识标识的卷。

cloudshell:~$ 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 向快照添加用户标记

您可以使用 API 将用户标记添加到快照。

发出 PATCH /snapshots 调用并指定快照标识和用户标记。以下示例将用户标记 env:test 和 env:prod 添加到快照。

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"
       ]
    }'

当用户标记与备份策略匹配时，将根据备份计划调度触发备份。有关更多信息，请参阅创建备份策略。

在控制台中编辑快速恢复区

使用以下步骤编辑控制台中存储快速恢复克隆的区段。您可以根据需要添加或除去区域。

从快照列表中选择快照。
从操作菜单中，选择 编辑快速复原。
从侧面板中，选择或取消选择区域以在区域中进行快速复原。根据您的选择复审计费更新。
单击保存。您将返回到快照详细信息页面。 “快速复原”部分显示最初处于暂挂状态的新区域。

刷新时将更新快速复原信息。根据您的更改，将更新区域信息以显示“已启用”或“已禁用”。

创建快照克隆以从 CLI 快速复原

要创建快照的区域副本，请发出带有快照标识的 ibmcloud is snapshot-clone-create 命令以及要在其中创建副本的一个或多个区域。以下命令示例在 eu-de-3 区域中创建 r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 的快速复原克隆。

cloudshell:~$ 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

创建快照克隆时，快照克隆似乎不可用。只需要几秒钟。发出带有快照标识和克隆目标区域的 ibmcloud is snapshot-cl 命令，以查看可用的新快照克隆。

cloudshell:~$ 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 删除快照克隆

要删除快照克隆，请发出带有快照标识的 ibmcloud is snapshot-clone-delete 命令以及要在其中除去快照副本的区域。以下命令示例删除 eu-de-3 区域中快照 r138-4463eb2c-4913-43b1-b9bf-62a94f74c146 的快速复原副本。

@cloudshell:~$ 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。

创建快照克隆以使用 API 进行快速复原

要创建快速复原快照，请在其他区域中创建快照的克隆。然后，从该克隆复原卷。

在 API 中，通过发出 PUT /snapshots/{id}/clones/{zone_name} 调用以将快照克隆到指定的区域，为现有快照创建克隆。请参阅以下示例。

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,
}

您还可以在创建卷快照时指定 clone 属性。请参阅以下示例。

curl -X POST \
"$vpc_api_endpoint/v1/snapshots?version=2025-02-18&generation=2" \
-H "Authorization: $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 删除快照克隆

发出 DELETE /v1/snapshots/{id}/clones/{zone-name} 调用以删除指定区域中的快照克隆。删除快照克隆时，无法撤销删除。

请参阅以下示例。

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 快照”列表或从“快照详细信息”页面创建跨区域快照副本。

在控制台中，单击 导航菜单 图标 > 基础架构 > 存储 > Block Storage快照。
在快照列表中，查找要在其他区域中复制的快照。确保快照处于稳定状态。
单击“操作”菜单 ()，然后选择 复制快照。
选择要创建副本的区域。

每个地区只能有一份副本。如果没有可用于副本的区域，那么将禁用“复制快照”选项。
单击创建。

或者，单击快照的名称以查看其详细信息。您可以从 “操作”菜单访问“复制快照”选项，也可以滚动到远程副本卡，然后单击“创建副本”。将打开同一供应面板，您可以在其中选择区域。

在控制台中删除远程区域副本

远程区域中的快照副本独立于父快照和父卷。您可以随时使用 VPC 的快照列表将其删除。

使用以下步骤在控制台中删除远程区域副本。

在 IBM Cloud 控制台中，转到菜单 > 基础架构 > 存储 > 快照。
单击要删除的快照行中的操作图标。
选择删除。
确认删除，然后单击删除。

从 CLI 创建远程区域副本

您可以使用带有 --source-snapshot-crn 选项的 snapshot-create 命令和源快照 CRN 来创建快照的跨区域副本，这将使用来自源区域的快照的 CRN 在目标区域中创建快照。如果还指定了加密密钥的 CRN，那么创建的快照将使用客户定义的加密密钥。要成功创建副本，源快照必须处于稳定状态。

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 命令来删除快照的跨区域副本。

cloudshell:~$ 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 调用来创建快照的跨区域副本。指定源快照的 CRN，以便在目标区域创建副本。如果还指定了加密密钥的 CRN，那么创建的快照将使用客户定义的加密密钥。要成功创建副本，源快照必须处于稳定状态。请参阅以下示例，其中目标区域为 us-east，原始快照位于 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 删除快照的远程区域副本

在远程拷贝所在的目标区域中创建 DELETE /snapshots/{id}。

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

使用 Terraform 创建跨区域副本

要在远程区域中创建快照的副本，请使用 ibm_is_snapshot 资源。要成功创建副本，源快照必须处于稳定状态。如果还指定了加密密钥的 CRN，那么创建的快照将使用客户定义的加密密钥。以下示例使用源 Snapshot 的标识在目标区域中创建副本。副本将通过其 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 命令可以方便地删除远程对象，例如快照的跨区域副本。以下示例显示了用于删除快照的语法。将快照的实际标识替换为 ibm_is_snapshot.example.id。

terraform destroy --target ibm_is_snapshot.example.id

有关更多信息，请参阅 terraform destroy。

在控制台中删除快照

您可以删除卷的任何快照或卷的所有快照。要能够删除快照，它必须满足以下先决条件:

处于 stable 或 pending 状态。
未主动复原卷。

确定是否可以删除快照的简单方法是在控制台中查找快照列表并检查其状态。您可以删除卷的所有快照。删除所有快照需要在控制台中进一步确认。

在控制台中删除单个快照

您可以使用以下步骤从所有快照的列表中删除快照。

转至所有快照的列表。在 IBM Cloud 控制台中，转到菜单 > 基础架构 > 存储 > 快照。
单击要删除的快照行中的操作图标。
选择删除。
确认删除，然后单击删除。

您还可以从 Block Storage for VPC 卷的详细信息页面中删除快照。

转至所有 Block Storage for VPC 卷的列表。在 IBM Cloud 控制台，单击 导航菜单 图标 > 基础架构 > 存储 > Block Storage卷。
从列表中选择卷，然后单击卷名称以转至卷详细信息页面。
点击快照。将显示对此卷生成的快照的列表，您可以执行以下操作:
- 单击 全部删除 以删除此卷的所有快照。
- 单击操作图标以删除特定快照。
选择删除。如果快照正在主动复原卷，那么删除操作不起作用。
确认此删除操作。

在控制台中删除卷的所有快照

要在控制台中删除卷的所有快照，请按照以下步骤操作。

转至所有快照的列表。在 IBM Cloud 控制台中，转到菜单 > 基础架构 > 存储 > 快照。
单击该行以选择要删除的快照。
从操作菜单中，选择 删除卷的全部。
通过输入 delete 确认删除，然后单击删除。

从控制台中的 Block Storage for VPC 详情页面删除快照

您可以从 Block Storage for VPC 卷详细信息页面的快照列表中删除最近创建的快照。 (可选) 您可以从此视图中删除所有快照。

转至所有 Block Storage for VPC 卷的列表。在 IBM Cloud 控制台，转到菜单 > 基础架构 > 存储 > Block Storage卷。
从列表中选择卷，然后单击卷名称以转至卷详细信息页面。
单击快照以查看此卷的快照列表。
单击 全部删除 以删除此卷的所有快照。
或者，在列表中选择单个快照以进行删除，然后:
1. 单击操作图标。
2. 选择删除。
3. 确认此删除操作。

从 CLI 删除快照

您可以删除卷的任何快照或卷的所有快照。要能够删除快照，它必须满足以下先决条件:

处于 stable 或 pending 状态。
未主动复原卷。

从 CLI 删除单个快照

使用以下步骤通过 CLI 删除单个快照。

列出可用于卷的快照，以确认要删除的快照的标识。

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

cloudshell:~$ 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 命令并指定快照的标识。要删除多个快照，必须在同一命令中指定其所有标识。
```
ibmcloud is snapshot-delete SNAPSHOT_ID
```

确认删除快照。响应消息指示已删除快照。

cloudshell:~$ 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 删除所有快照

使用以下步骤通过 CLI 删除所有快照。

列出所有快照。

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

输入 snapshots-delete 命令并指定卷标识。

ibmcloud is snapshots-delete --volume VOLUME_ID

确认删除快照。响应消息指示何时接受快照删除请求以及何时删除快照。

cloudshell:~$ 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 删除快照

您可以删除卷的任何快照或卷的所有快照。要能够删除快照，它必须满足以下先决条件:

处于 stable 或 pending 状态。
未主动复原卷。

使用 API 删除单个快照

发出 DELETE /snapshots/{snapshot_ID} 调用以按标识删除特定快照。

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 删除卷的所有快照

进行 DELETE/snapshots 调用，并在请求中指定 source_volume.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 删除快照

您可以删除卷的任何快照或卷的所有快照。要能够删除快照，它必须满足以下先决条件:

处于 stable 或 pending 状态。
未主动复原卷。

使用 Terraform 删除单个快照

使用 terraform destroy 命令可以方便地删除远程对象，例如单个快照。下面的示例删除了 my-snapshot。

terraform destroy --target ibm_is_snapshot.my-snapshot

有关更多信息，请参阅 terraform destroy。

删除具有 Terraform 的卷的所有快照

要删除具有 Terraform 的卷的所有快照，请使用 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 描述了快照生命周期中的快照状态。你可以在控制台、CLI 命令输出、API 响应和 Terraform 数据源中看到这些状态。

快照生命周期状态
快照状态	说明
稳定	快照可用于复原卷。
正在等待	正在检索快照信息。
暂挂	创建快照时，将显示已完成的百分比。
失败	快照创建失败，无法从快照恢复卷。
已暂挂	快照暂时不可用。
正在更新	您已更改有关快照的内容，并且正在对其进行更新。
正在删除	快照正在删除。
已删除	快照已删除，不可用于复原卷。

后续步骤

您可以从快照复原卷。