用例

快照功能有多种用途。 请考虑以下示例：

• 管理员计划升级中间件。 如果中间件升级失败，管理员必须将源磁盘恢复到原始状态。
• 管理员完成以下步骤：
  1. 使用 API 命令 启动中间件信息所在源磁盘的快照。 创建源磁盘快照。
  2. 升级中间件。
  3. 如果升级失败，管理员会使用快照还原源磁盘。
  4. 如果升级成功，管理员会删除快照。

您可以启动多个快照操作。 不过，这些并发快照操作发生在不同的磁盘组上。

用例

请考虑以下情况来还原快照：

• 复原属于 VM 快照的所有卷
• 运行多个 VM 复原操作
• 如果 VM 复原操作最初失败，请重试该操作
• 将 VM 回滚到其原始卷状态

先决条件

在开始创建卷克隆请求之前，确保满足以下前提条件：

• 对于工作区来说，卷克隆请求名称必须是唯一的。 如果要重复使用卷克隆请求名称，请删除具有该名称的现有卷克隆请求，然后重复使用该名称。

• 要包含在卷克隆请求中的卷必须位于同一个存储池中。

• 要包含在 volume-clone 请求中的卷必须不处于 error 状态，且卷的健康状态必须为 ok。

• 关闭访问要包含在卷克隆请求中的卷集的应用程序。

使用 API 和 CLI 命令创建加密卷克隆请求

Prepare action 操作完成了为要克隆的卷创建组快照的准备工作。

先决条件

在启动 Prepare action 操作前，确保满足以下前提条件：

• 至少两个卷
• 至少有一卷处于 in-use 状态
• 唯一卷-克隆名称

当 Prepare action 操作正在进行时，不能对同一组卷触发另一个 Prepare action 操作。 Prepare action 操作之后必须有 Start 和 Execute 操作。 如果不使用现有的 Prepare action 操作，则必须先取消现有操作，然后再启动下一个 Prepare action 操作。

使用以下 API 和 CLI 命令启动 Prepare action 操作：

• API：创建新卷克隆请求并启动准备操作
• CLI: ibmcloud pi volume clone create

您必须在 API 和 CLI 命令中提供以下参数值：

• name：（必填）提供要分配给加密卷-克隆请求的名称。 该名称在所有现有的加密卷-克隆请求中必须是唯一的。
• volumeIDs:提供要克隆的卷标识符或名称列表。 至少需要两个卷 ID，其中至少一个卷必须处于 in-use 状态。 卷克隆请求中包含的所有卷必须位于同一个存储池中。

当 Prepare action 运行到 100% 时，Prepare 的状态会根据以下条件发生变化：

• 如果 Prepare action 成功完成，状态将变为 prepared。
• 如果 Prepare action 未能成功完成，状态将变为 failed。

要检查 Prepare action 操作的状态，请使用带 volumesCloneID 选项的 API 或 CLI 命令。

限制和注意事项

• 至少需要 2 个加密卷 ID，其中至少一个必须处于 in-use 状态。

要克隆单个卷，您可以使用 为指定卷创建卷克隆 API 或 ibmcloud pi volume clone-async CLI 命令。 要检查单个卷克隆的状态，您可以使用 获取指定克隆任务 ID API 的卷克隆请求的状态 或 ibmcloud pi volume clone-async get CLI 命令。

• 对处于 in-use 状态的卷执行克隆操作时，Power Virtual Server 会创建一致的组快照，并使用组快照重新创建克隆卷的副本。

• 克隆操作正在进行时，不能修改源磁盘或目标磁盘的属性（如磁盘大小）。

• 不能尝试将作为一致性组一部分的卷克隆为现有一致性组的一部分。 必须运行 volumes-clone 启动请求后，卷才会属于一致性组，或者卷是快照 create 操作的一部分，后台闪存复制已完成。

• 卷不能从一个存储池克隆到另一个存储池。

使用 API 和 CLI 命令启动卷克隆请求

加密卷请求的初始状态设置为 Starting。

使用以下 API 和 CLI 命令启动卷克隆请求：

• API：启动卷克隆请求的 "开始 "操作
• CLI: ibmcloud pi volume clone start

您必须在 volume_clones_id 参数中提供卷克隆请求的唯一标识符。 标识符可以是加密卷 ID 或加密卷名称。

启动加密卷克隆请求时，初始状态设置为 Starting。 创建组快照后，请求状态将变为 Available。 start 卷克隆请求的操作是同步的。 当 API 调用返回客户端时，除非发生错误，否则卷-克隆请求状态会更改为 Available。 如果在 start 操作过程中发生错误，卷克隆请求的状态将变为 Failed。 失败原因在随 start 操作响应返回的错误中说明。 将除去已准备好的快照数据，以便您可以再次克隆同一组卷。 如果取消卷克隆请求的 start 操作，卷克隆请求的状态将变为 Cancelling。 当卷-克隆请求处于 Available 状态时，可以取消卷-克隆请求。

限制和注意事项

在启动加密卷克隆请求之前，必须考虑以下限制和注意事项：

• 至少需要两个加密卷 ID，其中至少一个必须处于 in-use 状态。

• 对处于 in-use 状态的卷执行克隆操作时，Power Virtual Server 会创建一致的组快照，并使用组快照重新创建克隆卷的副本。

• 克隆操作正在进行时，不能修改源磁盘或目标磁盘属性，如磁盘大小。

先决条件

卷-克隆请求必须处于 Available 状态。

使用 API 和 CLI 命令执行卷克隆请求

启动 execute 操作后，初始 percentComplete 将为 0%，状态设置为 executing。

使用以下 API 和 CLI 命令启动卷克隆请求：

• API：启动卷克隆请求的执行操作
• CLI: ibmcloud pi volume clone execute

您必须在 API 和 CLI 命令中提供以下参数值：

• volume-clones-id：（必填）卷克隆请求的唯一标识符。 标识符可以是加密卷 ID 或加密卷名称。
• name：（必填）新克隆卷的基本名称。 克隆卷名称前缀为 clone-，后缀为 -#####-N。 在后缀中，##### 是一个五位数的随机数，N 是一个以 1 开头的递增数。
• rollbackPrepare：（可选） 默认值为 False。 当标记设置为 False 时，系统会运行失败的回滚克隆活动，但准备好的快照保持原样。 当标记设置为 True 时，系统会运行故障回滚克隆活动并删除准备好的快照。
• userTags：（可选）提供要附加到克隆卷的用户标记列表。
• targetReplicationEnabled：（可选）使用此标记启用或禁用克隆卷的复制。 默认情况下，该标记使用正在克隆的源卷的复制状态。 当设置为 False 时，克隆卷不启用复制功能。 当设置为 True 时，克隆卷将启用复制功能。

如果源卷未启用复制功能，而您要为克隆卷启用复制功能，则必须启用源卷所在存储池的复制功能。

• targetStorageTier:提供克隆卷的存储层名称。 使用此字段可将一组卷从一个存储层克隆到另一个存储层。 克隆卷必须与源卷保持在同一存储池中。

限制和注意事项

在启动加密卷克隆请求之前，必须考虑以下限制和注意事项：

• 当卷-克隆请求的状态变为 completed、failed 或 cancelled 状态之一时，卷-克隆请求即被视为完成。
• 当 volumes-clone execute 请求启动时，初始状态设置为 executing。
• execute 操作成功完成后，卷克隆请求状态将变为 completed。
• 如果在卷克隆过程中发生错误，那么将除去由克隆过程创建的任何工件。 组快照将返回 available 状态，以便您重试 execute 操作。
• 当卷克隆请求处于 executing 状态时，可以取消该请求。
• 如果取消加密卷克隆请求的 execute 操作，加密卷克隆请求的状态将更改为 cancelling。
• 您可以使用 rollbackPrepare 选项来控制 execute 操作失败后的行为。 rollbackPrepare 选项的默认值是 false。 默认值会导致失败的 execute 操作回滚克隆活动，但不会删除准备好的快照。 如果 rollbackPrepare 选项设置为 true，则会导致失败的 execute 操作回滚克隆活动并删除准备好的快照。

先决条件

卷-克隆请求必须处于 Available 状态。

使用 API 和 CLI 命令取消加密卷复制请求

启动 cancel 操作后，初始 percentComplete 将为 0%，状态设置为 cancelling。

使用以下 API 和 CLI 命令取消加密卷克隆请求：

• API：取消卷克隆请求
• CLI: ibmcloud pi volume clone cancel

您必须在 API 和 CLI 命令中提供以下参数值：

• volume-clones-id：（必填）卷克隆请求的唯一标识符。 标识符可以是加密卷 ID 或加密卷名称
• Force：（可选） 默认状态为 False。 只有当状态设置为 prepared 或 available 时，才允许执行 cancel 操作。 当状态设置为 True 时，当状态设置为 NOT completed, cancelling, cancelled 或 failed 时，允许进行 cancel 操作。

限制和注意事项

在取消加密卷克隆请求前，必须考虑以下限制和注意事项：

• 如果取消加密卷克隆请求，加密卷克隆请求的初始状态将设为 Cancelling。 当所有清理工作顺利完成后，状态将变为 Cancelled。
• 当卷-克隆请求处于 executing 状态时，可以取消卷-克隆请求。 在 cancel volumes-clone 请求中，必须将 force 选项设置为 True。
• 如果卷-克隆请求处于 Executing 状态，克隆操作过程中创建的任何工件都会被移除。

先决条件

卷-克隆请求必须处于以下最终状态之一：Completed, Failed，或 Cancelled。

使用 API 和 CLI 命令删除加密卷克隆请求

使用以下 API 和 CLI 命令删除卷-克隆请求：

• API：删除卷克隆请求
• CLI: ibmcloud pi volume clone delete

您必须在 API 和 CLI 命令中提供以下参数值：

• volume-clones-id：（必填）卷克隆请求的唯一标识符。 标识符可以是加密卷 ID 或加密卷名称。
• Force：（可选）强制取消卷克隆请求。 只有当状态设置为 prepared 或 available 时，才允许执行 cancel 操作。 当状态设置为 True 时，当状态设置为 NOT completed, cancelling, cancelled 或 failed 时，允许进行 cancel 操作。

限制和注意事项

如果卷克隆请求未处于删除所需的最终状态之一，则可以取消请求，进行剩余清理，并将状态转换为 Cancelled。 如果卷-克隆请求处于 Cancelled 状态，则可删除该请求。

先决条件

无。

使用 API 和 CLI 命令获取卷克隆请求的状态

• API：获取指定克隆任务 ID 的卷克隆请求状态
• CLI: ibmcloud pi volume clone get

为 volume-clones-id 字段提供一个值。 该值是卷克隆请求的唯一标识符。 标识符可以是加密卷 ID 或加密卷名称。

限制和注意事项

无。

先决条件

无。

使用 API 和 CLI 命令获取卷克隆请求列表

• API：获取云实例的卷列表-克隆请求
• CLI: ibmcloud pi 卷克隆列表

从以下列表中为 filter 参数提供一个值：

• prepare- 包括状态值（准备、准备好）
• start- 包括状态值（启动、可用）
• execute- 包括状态值（正在执行、可用-回滚）
• cancel- 包括状态值（取消）
• completed- 包括状态值（已完成）
• failed- 包括状态值（失败）
• cancelled- 包括状态值（已取消）
• finalized- 包括状态值（完成、失败、取消）

限制和注意事项

在获取加密卷-克隆请求列表之前，必须考虑以下限制和注意事项：

• 未提供有关源卷或克隆卷的详细信息。

• 可以使用 filter 参数对列表进行限制。 过滤器是基于“过滤器”参数的状态。