从快照恢复卷

从快照复原数据将创建一个新的完全供应卷，您可以使用该卷来启动实例或将其作为辅助存储器进行连接。您可以在创建实例期间或修改现有实例时复原引导卷和数据卷。您还可以从快照创建独立数据卷。可以从手动创建的快照或通过备份策略复原卷。您还可以从快照的快速复原克隆和跨区域副本复原卷。你可以通过控制台、CLI、API 或 Terraform 从快照创建卷。

关于从快照复原卷

从快照复原卷将创建引导卷或数据卷，具体取决于快照是可引导卷还是不可引导卷。

从 可引导 快照复原将创建可用于启动虚拟服务器实例的引导卷。启动卷容量限制为10-250 GB。
从不可启动快照创建的新数据卷继承了原始卷的属性，例如配置文件、容量、存储生成、数据和元数据。如果源卷使用了客户管理的加密，那么该卷将使用原始客户根密钥 (CRK) 继承该加密。不过，您可以指定更大的容量、同一代存储器的不同规格，以及不同的CRK。

您可以从按需快照或备份策略创建的快照中还原卷。有关更多信息，请参阅从备份快照复原卷。

您可以使用快照的跨区域副本来复原其他区域中的卷。有关更多信息，请参阅跨区域快照。

您还可以选择使用快速复原快照克隆来复原卷。有关快速复原的更多信息，请参阅常见问题解答。

如果计划使用其他账户的快照，请确保正确的 IAM 授权和 IAM 角色到位。联系快照所有者以获取快照的 CRN。

您可以在 VPC 生命周期的各个阶段复原卷。

供应虚拟服务器实例时，可以指定引导快照或数据卷快照。复原的引导卷用于启动新实例。复原的数据卷将作为辅助存储器自动连接到实例。
当您想要向现有实例添加新的辅助存储器时，可以从不可引导的快照复原数据卷。
从快照创建未连接 (独立) Block Storage for VPC 卷时，仍可以稍后将该卷连接到实例。

不支持直接从快照一致性组标识复原实例。但是，您可以通过从属于一致性组的快照复原虚拟服务器实例的所有引导卷和数据卷来复原虚拟服务器实例。

所有快照都继承父卷的加密类型和密钥。从第一代快照创建卷时，可以保持加密与快照相同，也可以更改密钥。当第一代快照使用提供商管理的密钥保护时，您也可以选择添加客户管理的密钥。如果快照使用客户管理密钥保护，新卷也必须使用客户管理密钥。从第二代快照创建卷时，卷的加密类型（提供商管理或客户管理）必须与快照相同。

限制

从快照复原卷时，以下限制适用。

要复原卷，快照必须处于稳定状态。
您可以随时删除新卷。
除非水合完成或删除卷，否则无法删除从中复原卷的快照。
如果快照受客户管理的加密保护，并且您未指定其他根密钥 CRN，那么复原的卷将使用快照的加密密钥进行加密。以后无法更改加密。
创建新卷时，将立即开始数据复原，但性能会下降，直到卷完全水合为止。
第一代和第二代体积曲线不能互换。您可以使用第二代卷的快照创建另一个第二代卷，但不能将卷配置文件切换为第一代卷配置文件。同样，您可以使用第一代卷的快照创建具有相同数据的另一个第一代卷，但不能将新卷切换到 sdp 配置文件。

Hyper Protect Crypto Services 已被废弃。客户可以在 2027 年 3 月 20 日之前使用现有实例。如需了解更多信息，请参阅《 IBM Cloud Hyper Protect Crypto Services 已弃用》。为了持续保障安全，建议将现有的加密密钥迁移到专用的 Key Protect 实例中。如需了解更多信息，请参阅《迁移指南》。

性能影响

从快照复原数据时，引导卷和数据卷的性能最初会降低。恢复过程中会出现性能下降，因为数据会在后台从区域存储库复制到 Block Storage for VPC。

起初，恢复的卷显示为_待处理_或_降级_，服务开始从存储在单独区域存储库中的快照中提取数据。复制数据时，卷资源会监视卷的运行状态。在水合过程中，可以将卷连接到虚拟服务器或将其拆离。复原过程完成后，可以在新卷上实现完整的 IOPS。

从快速复原克隆复原的卷不需要水合。创建卷后，数据立即可用。但是，要在供应多个实例时实现最佳性能和效率，请从现有映像进行引导。您提供的定制图像优于用于此目的的库存图像。有关更多信息，请参阅定制映像入门。

使用快速复原来复原卷

使用快速复原快照克隆来复原卷将在创建时创建完全供应的卷。

使用快速恢复功能，您可以在区域内的一个区域而不是单独的区域存储库中创建并保存快照的克隆。从快速复原快照复原数据时，将从区域内的克隆中提取数据。由于数据立即可用，因此无需进行水合。性能级别不受影响。通过使用快速复原快照，可以比从常规快照复原更快地实现恢复时间目标在灾难恢复计划中，指灾难发生后业务流程恢复所需的时间。 (RTO)。

您还可以将快速复原功能与备份服务配合使用。有关更多信息，请参阅创建备份策略和计划。

在控制台中从快照恢复卷

您可以在 IBM Cloud 控制台的各个页面创建卷。从可引导快照复原将创建用于供应虚拟服务器实例的引导卷。启动卷的容量上限为250 GB。创建数据卷并将其连接到实例。您还可以从实例供应外部的快照复原卷，可以为现有实例创建独立卷和新的辅助卷。

从控制台中的快照列表创建卷

您可以从 Block Storage for VPC 快照列表中创建 Block Storage for VPC 卷，并指定该卷是附加到虚拟服务器实例还是不附加（独立）。如果选择附加数据卷，那么可以选择现有虚拟服务器实例或选择创建实例。新卷将添加到 Block Storage for VPC 卷的列表。

转至 Block Storage for VPC 快照的列表。在 IBM Cloud控制台中，单击导航菜单图标 > 基础架构 > 存储 >Block Storage存储快照。
从列表中选择快照，或按其 CRN 进行搜索。它必须处于 stable 状态。
从操作菜单中，选择创建卷。
快照的详细信息显示在“从快照创建卷”侧面板中。请从以下三个选项中选择一个：
- 不附加-- 选择该选项后，您将开始创建独立加密卷
- 将新卷附加到现有虚拟服务器- 选择此选项，您就可以创建一个卷，并选择一个现有服务器将其附加。
- 将新卷附加到新的虚拟服务器- 选择此选项，可以同时创建卷和新的虚拟服务器实例。
完成选择后，请点击“配置卷”。
- 如果选择不附加或将新卷附加到现有虚拟服务器选项，则会转到用于 VPC 配置的块存储卷页面。快照已为您预选，您必须完成卷的其他详细信息：
  1. 查看位置信息。地理、区域和区域从 VPC 继承（例如，北美、达拉斯、Dallas-1 ）。您可以点击编辑图标 ，选择不同的位置。
  2. 在“详细信息”部分，必须指定加密卷的名称和加密卷要添加到的资源组。您还可以选择添加用户和访问管理标签。
    - 为卷指定有意义的名称。例如，提供用于描述计算或工作负载功能的名称。卷名必须以小写字母开头。卷名称最多可以是 63 个小写字母数字字符，并包括连字符 (-)。整个 VPC 中的加密卷名称必须是唯一的。您可以稍后编辑该名称。
    - 指定资源组。
    - 指定用户标签来组织资源，并供备份策略使用。
    - 指定在 IAM 中创建的访问管理标记，以帮助您管理卷的访问。
  3. 在可选配置部分，将为您预选快照。
    - 如果需要，还可以将备份策略应用到新卷。点击 “申请” 查看可选的保险条款和计划。
    - 查看附加到现有虚拟服务器部分。如果要创建独立卷，请确认是否选中了“不附加”复选框。如果要将卷附加到一个实例，请从框中移除复选框，然后从表中选择一个现有的虚拟服务器。
  4. 在 “配置文件”部分，您可以指定加密卷的性能配置文件、性能限制和容量。快照的存储生成值必须与所选卷配置文件的存储生成值一致。
    - 如果快照是从第 2 代卷创建的，则可以选择 sdp 配置文件。然后，指定卷的容量、请求的带宽限制和所需的 IOPS。卷的大小范围为 1 - 32,000 GB。可指定的 IOPS 范围为 100 - 64,000。吞吐量限制范围为 1000-8192 Mbps。
    - 如果快照来自第 1 代卷，则可以选择其中一个 _分层_配置文件。选择 general-purpose、5iops-tier 或 10iops-tier 后，下一步是指定卷容量。卷的大小为 10 - 16,000 GB。
    - 如果您的快照来自第 1 代卷，且您对性能的要求不属于任何 IOPS 层，您可以选择 custom 配置文件。然后，根据卷容量的适当范围指定卷的大小和 IOPS。输入 IOPS 值时，控制台会显示可接受的范围。您还可以单击存储大小链接，查看自定义卷配置文件的大小和 IOPS 范围。
  5. 在“静态加密”部分，可以选择使用 IBM 管理的密钥保持加密，默认情况下所有卷都已启用。或者，您也可以通过选择自己的密钥管理服务，来使用自己的加密密钥。要查找加密密钥，请选择以下选项之一：
    - 按实例定位：
      1. 从列表中选择数据加密实例。如果您还没有实例，可以点击链接创建一个。
      2. 选择存储在 Key Protect 实例中用于加密卷的数据加密密钥。
    - 通过 CRN 定位：输入用于加密加密卷的客户根密钥的 CRN。
    如果您选择第二代快照来创建加密卷，加密卷的加密类型必须与快照的加密类型一致。如果快照有提供商管理的密钥，请不要指定来自密钥管理服务的密钥。
  6. 完成后，单击创建块存储卷。
    - 如果您还没有准备好订购，或者只是想了解价格信息，您可以将侧板中看到的信息添加到估价单中。有关该功能如何工作的更多信息，请参阅估算成本。
  7. 显示 Block Storage for VPC 卷页面，其中一条信息显示卷正在创建（卷状态为_待定_ ）。创建加密卷时，会显示第二条信息（加密卷状态_可用_ ）。
  8. 要查看新卷的详细信息，请选择后一条消息中的查看资源链接，以转至“卷详细信息”页面。
  当您在控制台中刷新“Block Storage”卷列表时，新卷会显示在卷列表的开头。对于独立卷，“附件类型”列为空白 (-)。表行末尾的操作菜单提供了将 Block Storage 卷附加到实例的链接。
- 如果选择“将新卷附加到现有虚拟服务器”选项，则会跳转到“为 VPC 配置虚拟服务器”页面。如果是可启动快照，其数据将用于创建启动卷。如果是不可启动快照，其数据将用于创建数据卷。您必须按照 "使用用户界面创建虚拟服务器实例 " 中的描述，完成实例详细信息的其余部分。

从控制台的快照详细信息页面创建卷

按照以下步骤从控制台的快照详细信息页面创建卷。

转至 Block Storage for VPC 卷的列表，然后选择卷。在 IBM Cloud控制台中，单击导航菜单图标 > 基础架构 > 存储 >Block Storage存储卷。
在 Block Storage for VPC 卷详细信息页面上，选择 快照和备份 选项卡。将显示手动创建或由备份策略创建的快照的列表。
从列表中，单击快照名称以转至其详细信息页面。
从操作菜单中，选择 创建卷。
快照的详细信息显示在“从快照创建卷”侧面板中。请从以下三个选项中选择一个：
- 不附加-- 选择该选项后，您将开始创建独立加密卷
- 将新卷附加到现有虚拟服务器- 选择此选项，您就可以创建一个卷，并选择一个现有服务器将其附加。
- 将新卷附加到新的虚拟服务器- 选择此选项，可以同时创建卷和新的虚拟服务器实例。
选择后，单击“配置音量”。配置步骤与从快照列表创建卷的步骤相同。

从一致性组为虚拟服务器实例创建卷

按照以下步骤从控制台的一致性组页面为虚拟服务器实例创建卷。

转至 Block Storage for VPC 快照一致性组的列表。在 IBM Cloud控制台中，单击导航菜单图标 > 基础架构 > 存储 >Block Storage存储快照。
从列表中选择一个快照一致性组。它必须处于 stable 状态。
从“操作”图标中，选择 创建虚拟服务器。
- 如果该组具有多个可引导快照，那么可以选择要用于新虚拟服务器实例的引导卷的快照。然后，单击 配置虚拟服务器。
有关您的区域、配置文件、启动卷和数据卷的信息将填入 VPC 新虚拟服务器配置页面。

如果将概要文件选择更改为映像或 现有卷，那么将除去引导卷快照。数据卷部分还填充了来自一致性组的不可引导快照。您可以除去快照或创建其他数据卷。但是，如果除去了数据卷并要将其重新添加，那么必须返回到再次选择一致性组的步骤。
配置虚拟服务器实例的其他方面，例如联网和高级功能。

在控制台中配置虚拟服务器实例时从快照创建启动卷

执行以下步骤以在供应新的虚拟服务器实例时从快照创建引导和数据卷。

在 IBM Cloud控制台中，单击导航菜单图标 > 基础架构 > 计算 > 虚拟服务器实例。
单击创建并供应新实例。有关必填字段的详细信息，请参阅在控制台中创建虚拟服务器实例中的表格。
对于操作系统，单击 更改映像，然后单击快照选项卡。将列出最新的可引导快照。
- 如果要使用其他快照，请单击编辑。您可以从列表中选择可启动快照，或根据其 CRN 搜索特定快照。单击保存。此操作将在供应页面上的引导卷字段中填充快照数据。
- 若要更改启动卷的属性（例如名称、自动删除功能、加密或标签），请单击 “编辑”图标 更改所需的属性，然后单击保存。将在供应页面上更新引导卷信息。
要创建数据卷，请在“数据卷”下单击创建。这样会显示一个侧面板。
1. 选择“从快照导入”。展开列表以选择数据快照。缺省情况下，会选择最新的数据快照。但是，您可以从列表中选择任何快照。
2. 该快照包含原始源卷的属性，包括自动删除状态、标签、大小、配置文件和加密状态。您可以更改所有这些属性。请记住，稍后可以更改卷名，概要文件，大小和 IOPS，但在创建卷后无法更改加密类型或 CRK。
3. 选择唯一名称，指定大小，然后单击创建。数据卷信息将添加到“数据卷”列表中。
查看您对卷，实例概要文件，SSH 密钥和网络等的选择。
如果您对自己的选择感到满意，请单击 创建虚拟服务器实例。将使用您指定的卷创建新实例。新实例将显示在虚拟服务器实例列表中。
要查看实例详细信息，请单击实例名称。从快照复原的卷列示在 存储卷下。摄像头图标指示卷是从快照创建的。

使用 UI 从现有虚拟服务器实例的快照创建数据卷

您还可以根据现有实例的快照创建数据卷。从虚拟服务器实例列表中进行选择。

在 IBM Cloud 控制台中，单击导航菜单图标 > 基础架构 > 计算 > 虚拟服务器实例。
从列表中，单击实例的名称。实例必须处于 正在运行 状态。
在“实例详细信息”页面上，滚动到存储卷列表，然后单击 附加卷。这样会打开一个侧面板，供您定义卷连接。
从“连接存储卷”面板中，展开“块卷”列表，然后选择 创建数据卷。
您可以展开列表并选择快照，或根据其 CRN 搜索特定快照。
该快照包含原始源卷的属性，包括自动删除状态、标签、配置文件和加密设置。您可以更改所有这些属性。请记住，稍后可以更改卷名，概要文件，大小和 IOPS，但在创建卷后无法更改加密类型或 CRK。

如果您选择第二代快照来创建加密卷，加密卷的加密类型必须与快照的加密类型一致。如果快照有提供商管理的密钥，请不要指定来自密钥管理服务的密钥。
选择唯一名称，指定大小，然后单击保存。数据卷信息将添加到“数据卷”列表中。
单击保存。侧面板关闭，并且消息指示正在将复原的卷连接到实例。新卷将显示在存储卷列表中。将鼠标悬停在摄像头图标上，以查看从中创建快照的快照的名称。

从 CLI 从快照复原卷

从可启动快照恢复会创建一个启动卷，您可以用它来配置虚拟服务器实例。启动卷不能超过 250 GB。将创建数据卷并可将其连接到实例。您还可以从实例供应外部的快照复原卷，可以为现有实例创建独立卷和新的辅助卷。

准备工作

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

登录到 IBM Cloud®。
```
ibmcloud login --sso -a cloud.ibm.com
```
此命令会返回 URL 并提示输入密码。在浏览器中转至该 URL 并登录。如果成功，您将获得一次性密码。复制此密码并将其作为响应粘贴到提示上。成功认证后，系统会提示您选择帐户。如果您拥有多个账户，请选择您要登录的账户。响应任何剩余提示以完成登录。
收集有关要用于复原卷的一个或多个快照的信息。
- 如果要从单个快照复原卷，请首先找到该快照并查看其详细信息。您可以使用 CLI 查看区域中帐户的所有快照并从列表中进行选择。或者，您还可以列出特定卷的所有快照，并从输出中选择一个快照。然后，使用 ibmcloud is snapshots SNAPSHOT_ID 命令列出所选快照的详细信息。如果要从另一个账户的快照中还原卷，请联系快照所有者获取快照的 CRN。
- 如果要通过从一致性组复原多个卷来复原实例，那么需要收集有关一致性组中快照的信息。列出区域中的所有一致性组。当您需要通过还原来自两个一致性组的备份快照卷来恢复实例时，按备份作业 ID 筛选一致性组列表会非常有用——这种情况通常发生在原始实例上同时挂载了第一代和第二代卷时。
```
ibmcloud is snapshot-consistency-groups --backup-policy-job BACKUP_POLICY_JOB_ID
```
  然后，获取一致性组的 ID，并将其与 ibmcloud is snapshots 命令结合使用，以筛选出指定一致性组中的快照。请参阅以下示例。
```
ibmcloud is snapshots --snapshot-consistency-group CONSISTENCY_GROUP_ID
```

通过 CLI 从快照为新实例创建引导卷

使用引导卷 JSON 中的 source_snapshot 属性运行 ibmcloud is instance-create 命令。指定可引导快照的标识或名称。复原的引导卷用于初始化实例。

请参阅以下示例。

ibmcloud is instance-create my-instance-restore1 ea002578-ff10-41fe-9652-e63f7e0e3cba us-south-1 bx2-2x8 ba11a6f2-6c17-4fee-a4b5-5c016fe64376 --boot-volume '{"name":"boot-from-snapshot1","volume":{"name":"boot-from-snapshot1","profile":{"name":"general-purpose"},"source_snapshot":{"id":"d857c69f-d795-46ac-85e4-f26ca3001033"}}}'

成功的响应如下例所示。

Creating instance my-instance-restore1 in resource group under account Test Account as user test.user@ibm.com...
ID               r006-eded6dcd-4f3c-4e79-a0cb-00f7c72f38cd
Name             my-instance-restore1
CRN              crn:v1:bluemix:public:is:us-south-1/a1234567::instance:7101_eded6dcd-4f3c-4e79-a0cb-00f7c72f38cd
Status           pending
Profile          bx2-2x8
Architecture     amd64
vCPUs            2
Memory           8
Network(Gbps)    4
Image            ID                                         Name
                 6f153c4d-6a9a-496d-8063-5c39932f6ded       ibm-centos-7-6-minimal-amd64-2
VPC              ID                                         Name
                 ea002578-ff10-41fe-9652-e63f7e0e3cba       my-vpc
Zone             us-south-1
Resource group   ID                                         Name
                 cdc21b72d4f557b195de988b175e3d81           Default
Created          2022-06-14T17:03:30+08:00
Boot volume      ID                                   Name                  Attachment ID                            Attachment name
                 0651dacb-4589-4147-86b3-a77544598f93 boot-from-snapshot1                  r006-abf9dd2b-9d5d-41f1-849d-55a8ab580ddb                            boot-from-snapshot1

有关可用命令选项的更多信息，请参阅 ibmcloud is instance-create。

通过 CLI 从快照为新实例创建数据卷

使用 ibmcloud is instance-create 命令创建实例时，请在卷连接中指定 source_snapshot 参数和快照名称或标识。

请参阅以下示例。

ibmcloud is instance-create my-instance-restore1 ea002578-ff10-41fe-9652-e63f7e0e3cba us-south-1 bx2-2x8 ba11a6f2-6c17-4fee-a4b5-5c016fe64376 --volume-attach
'{
   "name":"datavol-from-snapshot",
   "volume":{
      "name":"datavol-from-snapshot",
      "profile":{
         "name":"general-purpose"
      },
      "source_snapshot":{
         "id":"6daaaa39-3d81-4d1d-81f8-e1f6a14f97f3"
      }
   }
}'

有关可用命令选项的更多信息，请参阅 ibmcloud is instance-create。

通过 CLI 从现有实例的快照创建数据卷

对于现有实例，请指定带有 source-snapshot 参数的 ibmcloud is instance-volume-attachment-add 命令以及快照的名称或标识。要从 CLI 查找快照的标识，请参阅从 CLI 查看快照。

请参阅以下示例。

ibmcloud is instance-volume-attachment-add data-vol-1 a67f49de-fccc-4e5c-824e-dcbd06d009af --profile general-purpose --source-snapshot 52de6e85-7068-4247-90fd-d2fa91fd9864

有关可用命令选项的更多信息，请参阅 ibmcloud is instance-volume-attachment-add。

从 CLI 从快照创建独立卷

您可以从 CLI 从快照创建独立 Block Storage for VPC 数据卷。该卷未连接到虚拟服务器实例。vol. 运行 ibmcloud is volume 命令时，响应会将附件类型显示为 unattached。稍后可以将卷连接到实例。

如果不确定要将卷连接到哪个虚拟服务器实例，请使用此选项。

运行 ibmcloud is volume-create 命令并指定 snapshot 参数以及快照的名称或标识。运行 ibmcloud is volume-create 命令并指定 snapshot 参数和快照的名称、ID 或 CRN。有关更多信息，请参阅从快照创建独立 Block Storage for VPC 卷。

下面的示例使用另一个账户快照的 CRN 创建了一个独立数据卷。

ibmcloud is volume-create my-new-volume general-purpose us-east-1 --snapshot crn:v1:bluemix:public:is:eu-east-1:a/a7654321::snapshot:r014-4463eb2c-4913-43b1-b9bf-62a94f74c146

Creating volume my-new-volume under account Test Account as user test.user@ibm.com...
ID                                     r014-dee9736d-08ee-4992-ba8d-3b64a4f0baac
Name                                   my-new-volume
CRN                                    crn:v1:bluemix:public:is:us-east-1:a/a1234567::volume:r014-dee9736d-08ee-4992-ba8d-3b64a4f0baac
Status                                 pending
Attachment state                       unattached
Capacity                               100
IOPS                                   3000
Bandwidth(Mbps)                        393
Profile                                general-purpose
Encryption key                         -
Encryption                             provider_managed
Resource group                         defaults
Created                                2024-07-15T16:14:59+00:00
Zone                                   us-east-1
Health State                           inapplicable
Volume Attachment Instance Reference   -
Active                                 false
Busy                                   false
Tags                                   -

有关可用命令选项的更多信息，请参阅 ibmcloud is volume-create。

使用 API 从快照复原卷

您可以在实例供应期间通过调用 VPC API 中的 /instances 方法以编程方式复原卷，如以下样本请求中所示。您还可以通过在 VPC API 中调用 /volumes 方法来创建独立卷。

开始之前，请收集有关要用于复原卷的一个或多个快照的信息。

如果要从单个快照复原卷，请首先找到该快照并查看其详细信息。您可以使用 API 列出区域中帐户的所有快照并从列表中进行选择。然后，检索快照详细信息。如果要从另一个账户的快照中还原卷，请联系快照所有者获取快照的 CRN。
如果要通过从一致性组复原多个卷来复原实例，那么需要收集有关一致性组中快照的信息。列出区域中的所有一致性组。当您需要通过还原来自两个一致性组的备份快照卷来恢复实例时，按备份作业 ID 筛选一致性组列表会非常有用——这种情况通常发生在原始实例上同时挂载了第一代和第二代卷时。然后，获取要复原的一致性组的标识，并使用该标识来检索快照一致性组详细信息。

storage_generation 属性值为1的快照只能用于创建具有相同 storage_generation 值的块存储卷。当您从快照创建卷时，快照的 storage_generation 值和所选卷配置文件必须匹配。

如果您选择的快照的 storage_generation 属性值为 2，则卷的加密类型必须与快照的加密类型相匹配。如果快照有提供商管理的密钥，请不要指定来自密钥管理服务的密钥。

使用 API 供应实例时创建引导卷

要在创建实例时从可引导快照复原引导卷，请发出 POST /instances 请求并在 source_snapshot 子属性中指定 boot_volume_attachment 属性和可引导快照标识。

请参阅以下示例。

curl -X POST \
"$vpc_api_endpoint/v1/instances?version=2025-01-21&generation=2" \
-H "Authorization: Bearer $iam_token" \
-H "Content-Type: application/json" \
-d '{
  "zone": {
    "name": "us-south-2"
  },
  "resource_group": {
    "id": "6edefe513d934fdd872e78ee6a8e73ef"
  },
  "name": "my-virtual-server-instance",
  "vpc": {
    "id": "r006-01030e3c-2663-4f7d-ac55-651929dafe37"
  },
  "user_data": "",
  "profile": {
    "name": "bx2-2x8"
  },
  "keys": [
    {
      "id": "r006-d17665a1-1359-4cc1-b983-735754a1e908"
    }
  ],
  "volume_attachments": [],
  "boot_volume_attachment": {
    "volume": {
      "name": "my-virtual-server-instance-boot-1737500760000",
      "capacity": 100,
      "profile": {
        "name": "general-purpose"
      },
      "source_snapshot": {
        "id": "r006-daefc524-2643-4444-a22d-7c38144cc529"
      }
    },
    "delete_volume_on_instance_delete": true
  },
  "metadata_service": {
    "enabled": false
  },
  "primary_network_attachment": {
    "name": "eth0",
    "virtual_network_interface": {
      "allow_ip_spoofing": false,
      "auto_delete": true,
      "enable_infrastructure_nat": true,
      "primary_ip": {
        "auto_delete": true
      },
      "subnet": {
        "id": "0727-f24237f5-bdf0-4b94-ab4c-167a44b8bcb5"
      },
      "security_groups": [
        {
          "id": "r006-f380e7ba-b671-4232-9492-ecf59a0e6e1e"
        }
      ],
      "protocol_state_filtering_mode": "auto"
    }
  },
  "network_attachments": [],
  "reservation_affinity": {
    "policy": "automatic"
  },
  "volume_bandwidth_qos_mode": "weighted"
}'

使用 API 供应实例时创建数据卷

要从快照复原数据卷并在引导时附加数据卷，请发出 POST /instances 请求并指定数据卷连接和快照标识。

curl -X POST \
"$vpc_api_endpoint/v1/instances?version=2022-06-14&generation=2" \
-H "Authorization: Bearer $iam_token" \
-H "Content-Type: application/json" \
-d '{
      "name": "my-server-name",
      "zone": {
         "name": "us-south-1"
      },
      "vpc": {
        "id": "4d27c489-8ad7-3c18-cbf4-2103d9f8da93"
      },
      "profile": {
         "name": "cx2-2x4"
      },
      "primary_network_interface": {
        "name": "region1example-net1",
        "subnet": {
           "id": ""
        }
      },
     "volume_attachments": [
        {
            "name": "restore-data-vol1",
            "delete_volume_on_instance_delete": true,
            "volume": {
                "profile": {
                    "name": "general-purpose"
                },
                "source_snapshot": {
                    "id": "bdcdc984-ba4e-4aef-84fb-e8448c3116b1"
                }
            }
        }
     ]
    "resource_group": {
        "id": "2fab2c7f-c09d-4c64-baf7-1453b7461493"
    }
}'

使用 API 从快照创建独立数据卷

您可以使用 API 从快照创建独立卷。如果不确定要将卷连接到哪个虚拟服务器实例，请使用此选项。或者，如果要从已从实例拆离的未连接卷复原数据。

要从快照还原独立的数据卷，请发送 POST /volumes 请求，并在 source_snapshot 属性中指定快照的ID、CRN或 URL。复原的卷容量 (以 GB 计) 必须至少是快照的最小容量。

以下示例请求创建基于 5 IOPS/GB 概要文件的 100-GB 卷。它指定与原始快照不同的根密钥。源快照由标识指定。

curl -X POST \
"$vpc_api_endpoint/v1/volumes/?version=2022-06-14&generation=2" \
-H "Authorization: Bearer $iam_token" \
-H "Content-Type: application/json" \
-d '{
     "name": "volume-from-snapshot-1",
     "capacity": 100,
     "profile": {
        "name": "5iops-tier"
     },
     "zone": {
        "name": "us-south-1"
     },
     "encryption_key":{
        "crn":"crn:[...]"
     },
     "source_snapshot:" {
        "id": "bdcdc984-ba4e-4aef-84fb-e8448c3116b1"
     }
   }`

如果要从另一个账户的快照中还原卷，可以使用_CRN_通过其 CRN 而不是 ID 来识别快照。

使用 Terraform 从快照复原卷

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

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

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

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

使用 Terraform 供应实例时创建引导卷

要在创建实例时从可引导快照复原引导卷，请使用 ibm_is_instance 资源。以下示例定义名为 my-server-name 的新实例和 cx2-2x4 概要文件，并从快照 eb373975-4171-4d91-81d2-c49efb033753 创建引导卷。

resource "ibm_is_instance" "example" {
  name    = "my-server-name"
  profile = "cx2-2x4"
  boot_volume {
    name     = "boot-restore"
    snapshot = eb373975-4171-4d91-81d2-c49efb033753
    tags     = ["dev:test"]
  }
  primary_network_interface {
    subnet = ibm_is_subnet.example.id
  }
  vpc  = 4d27c489-8ad7-3c18-cbf4-2103d9f8da93
  zone = "us-south-1"
  keys = [ibm_is_ssh_key.example.id]
}

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

使用 Terraform 创建数据卷并将其连接到实例

要从不可引导快照复原数据卷并将该卷连接到实例，请使用 ibm_is_instance_volume_attachment 资源。请参阅以下示例。

resource "ibm_is_instance_volume_attachment" "example" {
  instance = ibm_is_instance.example.id
  name = "test-attachment-1"
  profile = "general-purpose"
  snapshot = "ibm_is_snapshot.example.id"
  delete_volume_on_attachment_delete = true
  delete_volume_on_instance_delete = true
  volume_name = "restore-data-vol1"
  }

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

使用 Terraform 从快照创建独立数据卷

要从快照创建卷，请使用 ibm_is_volume 资源。以下示例使用通用性能概要文件从快照 bdcdc984-ba4e-4aef-84fb-e8448c3116b1 创建卷。

resource "ibm_is_volume" "storage" {
  name            = "restore-data-vol1"
  profile         = "general-purpose"
  zone            = "us-south-1"
  source_snapshot = "ibm_is_snapshot.example.id"
}

如果要从另一个账户的快照中还原卷，可以使用 "source_snapshot_crn 参数通过其 CRN 识别快照。

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

后续步骤

您可以创建更多快照或管理现有快照。