StartBulkVolumeRead

您可以使用 StartBulkVolumeRead 方法在指定卷上启动批量卷读取会话。

一个卷上只能同时运行两个批量卷进程。初始化该会话后,将从 SolidFire 存储卷读取要存储在外部备份源上的数据。外部数据可通过 Element 存储节点上运行的 Web 服务器访问。外部数据访问的服务器交互信息由运行于存储系统上的脚本传递。

在批量卷读取操作开始时,将生成卷的快照,并且会在读取操作完成后删除该快照。您也可以通过输入快照 ID 作为参数来读取卷的快照。读取先前的快照时,系统不会创建卷的新快照,而且不会在读取操作完成后删除先前的快照。
注:如果未提供现有快照的 ID,则此过程会创建新快照。当集群填充度处于第 2 或第 3 阶段时,可以创建快照。当集群填充度处于第 4 或第 5 阶段时,不会创建快照。

参数

此方法具有以下输入参数:

名称 说明 类型 默认值 必需
format 卷数据的格式。可以是下列任一项:
  • uncompressed:返回卷的每个字节,而不进行任何数据压缩。
  • native:返回较小的不透明数据,并在后续的批量卷写入操作更高效地存储和写入不透明数据。
字符串
volumeID 要读取的卷的 ID。 整型
snapshotID 先前为批量卷读取操作创建的快照的 ID。如果未输入 ID,则会指定当前的活动卷映像的快照。 整型
script 可执行脚本的名称。如果未指定脚本名称,则需要使用密钥和 URL 来访问 Element 存储节点。脚本将在主节点上运行,并且密钥和 URL 会返回到脚本中,以便可以与本地 Web 服务器联系。 字符串
scriptParameters 要传递到脚本的 JSON 参数。 JSON 对象
attributes 批量卷作业的 JSON 属性。 JSON 对象

返回值

此方法具有以下返回值:

名称 说明 类型
asyncHandle 要检查其完成情况的异步进程的 ID。 整型
key 唯一标识会话的不透明密钥。 字符串
url 用于访问节点的 Web 服务器的 URL。 字符串

请求示例

此方法的请求类似于以下示例:

{
   "method": "StartBulkVolumeRead",
   "params": {
      "volumeID" : 5,
      "format"  : "native",
      "snapshotID" : 2
   },
   "id": 1
}

响应示例

此方法返回类似于以下示例的响应:

{
      "id" : 1,
   "result" : {
      "asyncHandle" : 1,
      "key" : "11eed8f086539205beeaadd981aad130",
      "url" : "https://127.0.0.1:44000/"
   }
}

发布以下版本后新增

9.6