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