快照、恢复和克隆
IBM Power Virtual Server 于 IBM 数据中心
IBM Power Virtual Server 私有云 于 客户位置
IBM® Power® Virtual Server 提供捕获整个逻辑卷或数据集的完整时间点副本的功能。 使用 IBM 的 FlashCopyPower® Virtual Server API 的功能,可以创建 delta 快照、卷克隆和还原磁盘。
用例
快照功能有多种用途。 请考虑以下示例:
-
管理员计划升级中间件。 如果中间件升级失败,管理员必须将源磁盘恢复到原始状态。
-
管理员完成以下步骤:
-
使用图形用户界面、API 或 CLI 启动中间件信息所在源磁盘的快照。 创建源磁盘快照。
-
升级中间件。
-
如果升级失败,管理员会使用快照还原源磁盘。
-
如果升级成功,管理员会删除快照。
-
您可以启动多个快照操作。 不过,这些并发快照操作发生在不同的磁盘组上。
创建快照
快照是在特定时间拍摄的一个卷或一组卷的状态副本。 通过使用快照,可以将卷恢复到拍摄快照时的状态。
通过快照,您可以在指定时间在源磁盘和目标磁盘之间创建关系,例如 T1. 目标磁盘的创建是创建快照操作的一部分。 快照操作可追踪源磁盘上发生的超时变化。T1 时间之外对源磁盘所做的更改。 因此,您可以在稍后时间将源磁盘还原到它们的 T1 状态。
您可以使用图形用户界面、API 和 CLI 在 Power Virtual Server 工作区中创建和管理快照。
先决条件
-
在对卷进行快照之前,建议您关闭访问该卷的所有应用程序。 需要执行此操作以确保所有数据都被移动到磁盘上,从而避免数据丢失。
-
如果要创建多个虚拟服务器实例共享的卷的快照,则必须关闭所有这些虚拟服务器实例上的所有应用程序。 如果您不确定如何让应用程序停止运行,建议您关闭与要包含在快照中的卷相连的任何虚拟服务器实例。
-
工作区的快照名称必须是唯一的。 如果要重新使用快照名称,请删除带有该名称的现有快照,然后重新使用该名称。
-
快照中包含的卷必须在同一个存储池中。
-
要包含在快照中的卷必须不处于
error状态,且卷的健康状态必须是ok。
使用 Power Virtual Server 用户界面创建快照
要使用 Power Virtual Server 用户界面创建快照,请完成以下步骤:
-
打开 Power Virtual Server 用户界面 IBM Cloud 并使用凭据登录。
-
单击导航面板中的工作空间。 工作空间 "页面将显示现有工作空间的列表。
-
选择要创建快照的工作区。 显示工作区详细信息面板。
-
单击查看虚拟服务器。 显示虚拟服务器实例页面。
-
在导航面板中,单击存储 > 实例快照。 显示“实例快照”页面,其中包含所有现有快照的列表。
-
单击创建实例快照。 显示“创建实例快照”页面。
-
在常规部分,在名称字段中输入快照的名称。
-
可选:在用户标签(可选) 和描述字段中输入快照的用户标签和描述。
-
单击继续。
-
在卷部分中,从选择虚拟服务器实例列表中选择所需的虚拟服务器实例。 显示连接到所选虚拟服务器实例的任何存储卷。
-
选择要包含在快照中的存储卷,然后单击完成。 所选快照配置的摘要及其总估计成本显示在摘要面板中。
您可以选择多个要包含在快照中的存储卷。 不过,所有选定的卷必须属于同一个存储池。
-
可选:单击添加到估算,将成本信息添加到现有估算或创建新估算。
-
单击条款和条件链接,阅读 IBM Cloud 使用 条款。 要继续,请选择“**我同意条款和条件 **”复选框,然后单击“创建”。 快照创建成功后,屏幕上会显示一条成功信息。
您创建的快照将显示在“实例快照”页面中,并提供以下详细信息:
- 名称:快照名称。
- 卷:快照中包含的存储卷数量。
- 描述:快照描述。
- 虚拟服务器实例:虚拟服务器实例:创建快照时所选存储卷所连接的虚拟服务器实例的名称。
- 创建:表示创建快照时间的时间戳。
- 状态和状态详细信息:这两列显示快照的当前状态。 快照可以有以下状态之一:
- 可用:快照已成功创建,可用于还原操作。
- 错误:创建快照时发生错误。 快照无法恢复,必须删除。
- 还原:当前正在进行还原操作。
- 还原错误:还原过程中发生错误。 您可以使用溢出菜单中的还原选项重试还原过程。 要将具有“还原错误”状态的快照恢复到其最后的工作状态,可以使用快照详细信息页面上“操作”菜单中的“回滚”选项。
- 还原已恢复:还原尝试已还原,可能是因为快照中包含的存储卷当前正在执行另一个快照操作。 其他快照操作完成后,您可以重试还原。
- 回滚:当前正在进行回滚操作。 回滚操作将虚拟服务器实例还原到其最后的工作状态。
- 回滚错误:回滚过程中发生错误。
- 上次更新:表示快照上次更新时间的时间戳。
使用 API 或 CLI 命令创建快照
使用以下 API 和 CLI 命令创建快照:
-
API: 创建 PVM 实例快照。
-
CLI: ibmcloud pi snapshot create.
您必须在 API 和 CLI 命令中提供以下参数值:
-
name:(必填)指定快照的名称。name必须是工作区所有快照中唯一的值。 -
description:(可选)描述快照。 -
volumeIDs:(可选) 包括要包含在快照中的一个或多个卷的列表。 如果此参数留空,则快照中包括附加到虚拟服务器实例 (VSI) 的所有卷。
创建快照的限制和注意事项
创建快照时必须考虑以下限制和注意事项:
-
如果虚拟服务器实例的任何附加卷当前正在进行克隆或快照操作,则无法创建该实例的快照。
-
不能修改作为现有快照一部分的任何卷的可共享或可启动属性。
-
您不能在特定时间从不同的虚拟服务器实例针对同一共享卷并行运行快照操作。
-
如果卷包含在虚拟服务器实例快照中,则无法调整卷的大小。 要调整此类卷的大小,必须先删除该卷所属的所有快照。
-
无法从虚拟服务器实例中分离实例快照中包含的卷。 要分离这些卷,必须先删除这些卷所属的所有快照。
-
您必须将快照中包含的所有卷附加到同一个虚拟服务器实例。
-
使用 API 或 CLI 创建快照时,
volumeIDs参数是可选的。 如果未指定volumeIDs选项,快照中将包含附加到虚拟服务器实例的所有卷。 -
如果附加到虚拟服务器实例的卷不在同一个存储池中,则使用
volumeIDs选项来包含在同一个存储池中的卷。 在这种情况下,必须将同一存储池中的卷分组,并为存储池中的每个卷组创建快照。
如果创建快照的操作失败,会导致 error 状态。 您可以删除该快照,这样就无法对其执行其他操作。
恢复快照
restore 操作将虚拟服务器实例快照中的卷还原到源磁盘。 当还原操作正在进行时,Power Virtual Server 会创建一个备份快照,在还原操作失败时可以使用。 如果还原操作成功,备份快照将被删除。 如果还原操作失败,快照状态将设置为 restore-error。 您可以尝试重试还原或回滚操作,使其恢复到原始状态。 使用带有 retry 值的 restore_fail_action 查询参数重试还原操作。 要回滚到以前的磁盘状态,请使用 restore_fail_action 查询参数和 rollback 值。 还原操作失败时,虚拟服务器实例会进入错误状态。
先决条件
在启动 restore 操作前,确保满足以下前提条件:
-
默认情况下,必须先关闭虚拟服务器实例,然后才能启动
restore操作。 -
要在实时虚拟服务器实例上还原数据,请使用
force restore操作。 必须满足以下条件:- 让应用程序安静下来
- 不要在卷磁盘上运行 I/O 操作
如果不满足
force restore操作条件,可能会导致数据损坏。 -
如果要恢复多个虚拟服务器实例共享的卷的实例快照,则必须静止所有虚拟服务器实例上的所有应用程序。 此外,还原操作期间,共享卷上不得运行任何 I/O 操作。
-
如果您不确定如何让应用程序停止运行,建议您关闭与要包含在快照中的卷相连的任何虚拟服务器实例。
使用 Power Virtual Server 用户界面恢复快照
要使用 Power Virtual Server 用户界面还原快照,请完成以下步骤:
-
打开 Power Virtual Server 用户界面 IBM Cloud 并使用凭据登录。
-
单击导航面板中的工作空间。 工作空间 "页面将显示现有工作空间的列表。
-
选择包含要恢复的快照的工作区。 显示工作区详细信息面板。
-
单击查看虚拟服务器。 显示虚拟服务器实例页面。
-
在导航面板中,单击存储 > 实例快照。 显示“实例快照”页面,其中包含现有快照的列表。
-
从可用快照列表中,选择要还原的快照。 显示快照详细信息页面。
-
选择恢复。 此时将显示确认还原对话框。
要还原实例快照,必须首先关闭所有相关的虚拟服务器实例,包括源和附加到实例快照的任何共享卷。 如果无法关闭虚拟服务器实例,请关闭所有相关应用程序,并将强制还原设置为已启用。
-
单击复原。
开始还原时,系统会显示通知,说明还原过程已经开始,进度条会显示完成百分比。 快照成功还原后,“状态”详细信息列会显示“还原成功完成”状态。
还原操作失败会将快照状态更改为还原错误。 您可以使用溢出菜单中的还原选项重试还原过程。 要将具有“还原错误”状态的快照恢复到其最后的工作状态,请从快照详细信息页面的“操作”菜单中选择“回滚”。
使用 API 或 CLI 命令还原快照
使用以下 API 和 CLI 命令还原快照:
-
API:还原 PVM 实例快照。
-
CLI: ibmcloud pi snapshot-restore
您必须在 API 和 CLI 命令中提供以下参数值:
SNAPSHOT_ID:(必填)指定快照的唯一标识符force:(可选)指定标志值为True或False。 默认情况下,该标志设置为False。 只有当虚拟服务器实例关闭时,该标志才会被设置为true。 默认情况下,必须先关闭虚拟服务器实例,然后才能启动快照还原操作。 当force标志设置为True时,放宽了虚拟服务器实例关闭的前提条件。restore:(可选)只有在之前的还原操作导致快照设置为restore-error状态时,才使用restore_fail_action查询参数。restore_fail_action查询参数接受以下retry或rollback值:- 如果快照状态设置为
retry,则会再次尝试失败的还原操作。 - 如果快照状态设置为
rollback,则无法还原的卷将回滚到原始状态。
- 如果快照状态设置为
如果使用 force 选项,则必须确保访问实例快照中卷的所有应用程序都已停止,并且卷磁盘上没有正在运行的 I/O 操作。
用例
请考虑以下情况来还原快照:
- 还原虚拟服务器实例快照中的所有卷
- 运行多个虚拟服务器实例还原操作
- 如果虚拟服务器实例还原操作最初失败,则重试该操作
- 将虚拟服务器实例回滚到其原始卷状态
限制和注意事项
-
在系统开始对快照进行
restore操作之前,会创建一个仅供内部使用的临时卷备份快照。 如果快照restore操作失败,系统将使用临时备份将虚拟服务器实例还原到restore操作失败前的状态。 -
如果目标卷上正在运行任何复制操作,则不允许进行卷恢复操作。 对实例快照中的卷进行验证,以确保没有针对它们运行复制操作。 使用 API 获取卷的 FlashCopy 映射列表,或使用 CLI 命令 获取卷的 FlashCopy 映射列表。
-
执行
restore操作时,快照任务状态会更改为restoring,卷状态会更改为reverting,并且不允许执行其他快照操作。 -
当对虚拟服务器实例快照进行
restore操作失败时,虚拟服务器实例状态将变为restore-Error状态。 您可以重试restore操作,也可以请求将虚拟服务器实例回滚到restore操作失败前的原始状态。 -
如果在共享卷上执行
restore操作,则会恢复共享该卷的所有虚拟机。 -
如果在一台虚拟机上对共享卷执行
restore操作,则无法在使用共享卷的其他虚拟机上执行快照、还原、克隆或捕获操作。 -
在对启动盘执行
restore操作前,必须关闭虚拟机,且状态必须更改为shutoff状态。 -
成功执行
restore retry操作后,虚拟服务器实例状态可能无法从Error状态重置。 使用图形用户界面上的Reset State功能重置虚拟服务器实例状态。 -
如果快照是最近创建的,且
FlashCopy操作仍在后台运行,则无法还原虚拟服务器实例快照。FlashCopy操作必须首先完成。 使用 API 获取卷的 FlashCopy 映射列表,或使用 CLI 命令 获取卷的 FlashCopy 映射列表。 -
要还原已启用全局复制服务 (GRS) 进行卷复制的卷,所有卷必须属于同一个卷组。 如果快照包含来自不同卷组的多个启用 GRS 的卷,则无法还原卷。
删除快照
您可以使用图形用户界面、API 或 CLI 删除快照。
如果虚拟服务器实例有一个或多个相关快照,则无法删除该实例。 必须先删除所有相关快照,然后才能删除虚拟服务器实例。
使用 Power Virtual Server 用户界面删除快照
要使用 Power Virtual Server 用户界面删除快照,请完成以下步骤:
-
打开 Power Virtual Server 用户界面 IBM Cloud 并使用凭据登录。
-
单击导航面板中的工作空间。 工作空间 "页面将显示现有工作空间的列表。
-
选择包含要删除的快照的工作区。 显示工作区详细信息面板。
-
单击查看虚拟服务器。 显示虚拟服务器实例页面。
-
在导航面板中,单击存储 > 实例快照。 显示“实例快照”页面,其中包含现有快照的列表。
-
从可用快照列表中,选择要删除的快照。 显示快照详细信息页面。
-
从操作菜单中选择删除。 此时将显示确认删除对话框。
-
键入确认文本,然后单击“删除”。
快照成功删除后无法恢复。
使用 API 或 CLI 命令删除快照
使用以下 API 和 CLI 命令删除快照:
-
API:删除云实例的 PVM 实例快照。
-
CLI: ibmcloud pi snapshot-delete。
您必须在 API 和 CLI 命令中提供以下参数值:
SNAPSHOT_ID:(必填)指定快照的唯一标识符
快照的计量和定价
您创建的每个快照都会在每小时内受到监控,并根据快照所需的磁盘空间收费。 快照使用的空间按基本费率的 30% 收费。
例如,假设虚拟服务器实例上有 M 个磁盘,总计 600 GB 空间。 M 磁盘用作快照的源磁盘。 以下费用适用于 M 盘:
- 如果创建了一个快照,则需要支付基本的 600 GB M 磁盘使用的磁盘空间加上 600 GB 磁盘空间的 30% 的费用。 也就是说,600 GB(M 个磁盘空间)+ 180 GB(600 GB 的 30%)= 780 GB 磁盘空间。
- 如果使用相同的磁盘创建另一个快照,则需要支付 M 磁盘使用的磁盘空间费用。 也就是说,600 GB(M 个磁盘空间)+(600 GB 的 30%)+(600 GB 的 30%)= 960 GB 磁盘空间。
- 快照的定价是根据快照中各个源卷的卷大小和存储层级计算的。 例如,请参考下表计算具有卷 A 和卷 B 的快照的成本。
| 卷名 | 卷大小 | 层类型 | 一卷的成本 |
|---|---|---|---|
| A 卷 | 100 GB | 第 1 层 | 100 GB 的 30 |
| B 卷 | 30 GB | 第 0 层 | 30 GB 的 30 |
快照的成本是 A 卷和 B 卷成本的总和。
创建卷克隆
创建加密卷克隆请求
克隆操作会创建卷的完整副本。 您可以选择多个卷,并启动组克隆操作。 选择多个卷时,克隆操作可确保创建一致的数据副本。
克隆操作会在后台继续将数据从源磁盘复制到目标磁盘。 根据源磁盘的大小和要复制的数据量,克隆操作可能需要大量时间。
先决条件
在开始创建卷克隆请求之前,确保满足以下前提条件:
-
对于工作区来说,卷克隆请求名称必须是唯一的。 如果要重复使用卷克隆请求名称,请删除具有该名称的现有卷克隆请求,然后重复使用该名称。
-
要包含在卷克隆请求中的卷必须位于同一个存储池中。
-
要包含在 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 pivolume clone-async CLI 命令。 要检查单个卷克隆的状态,您可以使用 获取指定克隆任务 ID API 的卷克隆请求的状态 或 ibmcloud pivolume clone-async get CLI 命令。
-
对处于
in-use状态的卷执行克隆操作时,Power Virtual Server 会创建一致的组快照,并使用组快照重新创建克隆卷的副本。 -
克隆操作正在进行时,不能修改源磁盘或目标磁盘的属性(如磁盘大小)。
-
不能尝试将作为一致性组一部分的卷克隆为现有一致性组的一部分。 必须运行 volumes-clone 启动请求后,卷才会属于一致性组,或者卷是快照
create操作的一部分,后台闪存复制已完成。 -
卷不能从一个存储池克隆到另一个存储池。
启动卷克隆请求
此步骤允许一致性组启动 FlashCopy 操作。
前提条件是,卷-克隆请求必须处于 Prepared 状态。
使用 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操作回滚克隆活动并删除准备好的快照。
取消加密卷克隆请求
Cancel a volumes-clone request 操作会启动清理活动,对预备克隆和快照卷进行清理。
先决条件
卷-克隆请求必须处于 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状态时,可以取消卷-克隆请求。 在cancelvolumes-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 请求会返回有关卷克隆请求状态的详细信息。 例如,正在克隆的源卷列表和成功完成 execute 操作后的克隆卷列表。
先决条件
无。
使用 API 和 CLI 命令获取卷克隆请求的状态
- API:获取指定克隆任务 ID 的卷克隆请求状态
- CLI: ibmcloud pi volume clone get
为 volume-clones-id 字段提供一个值。 该值是卷克隆请求的唯一标识符。 标识符可以是加密卷 ID 或加密卷名称。
限制和注意事项
无。
获取卷列表-克隆请求
API 请求提供工作区中所有卷克隆请求的列表以及每个请求的状态。
先决条件
无。
使用 API 和 CLI 命令获取卷克隆请求列表
- API:获取云实例的卷列表-克隆请求
- CLI: ibmcloud pi 卷克隆列表
从以下列表中为 filter 参数提供一个值:
prepare- 包括状态值(准备、准备好)start- 包括状态值(启动、可用)execute- 包括状态值(正在执行、可用-回滚)cancel- 包括状态值(取消)completed- 包括状态值(已完成)failed- 包括状态值(失败)cancelled- 包括状态值(已取消)finalized- 包括状态值(完成、失败、取消)
限制和注意事项
在获取加密卷-克隆请求列表之前,必须考虑以下限制和注意事项:
-
不提供源卷或克隆卷的详细信息。
-
可以使用
filter参数对列表进行限制。 过滤器是基于“过滤器”参数的状态。
常见问题
以下是常问问题页面中记录的有关快照和克隆的一些常见问题: