AddDrives

您可以使用 AddDrives 方法将一个或多个可用驱动器添加到集群中，使这些驱动器可以托管集群的一部分数据。

向集群添加存储节点或在现有节点中安装新驱动器后，新驱动器会标记为可用，您必须先通过 AddDrives 添加这些驱动器，然后才能使用它们。使用 ListDrives 方法可显示可添加的驱动器。添加驱动器时，系统会自动确定此驱动器的类型。

此方法为异步方法，在启动集群驱动器重新平衡过程之后会立即返回。但是，要使用新添加的驱动器重新平衡集群中的数据，则可能需要更长的时间；即使在 AddDrives 方法调用完成之后，此重新平衡操作仍会继续执行。您可以使用 GetAsyncResult 方法查询此方法返回的 asyncHandle。AddDrives 方法返回后，您可以使用 ListSyncJobs 方法查看使用新驱动器重新平衡数据的进度。

注：添加多个驱动器时，在单个 AddDrives 方法调用中添加所有驱动器比使用多个调用逐个添加驱动器更高效。这样可减少使集群的存储负载保持稳定所需平衡的数据量。

参数

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

名称	说明	类型	默认值	必需
drives	关于要添加到集群的每个驱动器的信息。可能值： driveID：要添加的驱动器的 ID（整型）。 type：要添加的驱动器的类型（字符串）。有效值为“slice”、“block”或“volume”。如果省略，则系统将分配正确的类型。	JSON 对象数组	无	是（type 为可选）

返回值

此方法具有以下返回值：

名称	说明	类型
asyncHandle	用于获取操作结果的句柄值。	整型

请求示例

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

{
  "id": 1,
  "method": "AddDrives",
  "params": {
    "drives": [
      {
        "driveID": 1,
        "type": "slice"
      },
      {
        "driveID": 2,
        "type": "block"
      },
      {
        "driveID": 3,
        "type": "block"
      }
    ]
  }
}

响应示例

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

{
  "id": 1,
  "result" : {
    "asyncHandle": 1
  }
}

发布以下版本后新增

9.6