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