ModifyVolumes

您可以使用 ModifyVolumes 方法一次性配置最多 500 个现有卷。所做更改将立即生效。如果 ModifyVolumes 无法修改任一指定卷,则所有指定卷都不会发生更改。

如果在修改卷时未指定 QoS 值,则每个卷的 QoS 值保持不变。可以通过运行 GetDefaultQoS 方法来检索新创建的卷的默认 QoS 值。

如果需要增加所复制的卷的大小,请按以下顺序执行此操作以防止发生复制错误:
  1. 增加具有 replicationTarget 访问权限的卷的大小。
  2. 增加源卷或具有 readWrite 访问权限的卷的大小。

请确保目标卷和源卷的大小相同。

注: 如果将 access 状态更改为 lockedreplicationTarget,则所有现有 iSCSI 连接将终止。

参数

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

名称 说明 类型 默认值 必需
access 允许对卷执行的访问。可能值:
  • readOnly:仅允许执行读取操作。
  • readWrite:允许执行读取和写入。
  • locked:不允许执行任何读取或写入。如果未指定,则访问值不会更改。
  • replicationTarget:将一个卷标识为一组配对卷的目标卷。如果卷未进行配对,则访问状态为 locked。如果未指定值,则访问值不会更改。
字符串
accountID 将卷重新分配到的帐户 ID。如果未指定任何帐户 ID,将使用上一个帐户名称。 整型
associateWithQoSPolicy 将卷与指定的 QoS 策略相关联。可能值:
  • true:将卷与 QoSPolicyID 参数中指定的 QoS 策略相关联。
  • false:不将卷与 QoSPolicyID 参数中指定的 QoS 策略相关联。如果为 false,无论是否在 QoSPolicy 参数中指定 QoS 策略,都将删除任何现有的策略关联。
布尔型
attributes 名称-值对的列表,采用 JSON 对象格式。 JSON 对象
createTime 要设置为新卷创建日期的 ISO 8601 日期字符串。必填(如果 setCreateTime 设置为 true)。 ISO 8601 字符串
enableSnapMirrorReplication 确定卷是否可用于 SnapMirror 端点的复制。可能值:
  • true
  • false
布尔型 false
mode 卷复制模式。可能值:
  • asynch:等待系统确认数据存储在源上,然后再写入到目标。
  • sync:立即开始将数据写入到目标,而不等待来自源的数据传输确认。
字符串
qos 卷的新服务质量设置。如果未指定,则 QoS 设置不会更改。可能值:
  • minIOPS
  • maxIOPS
  • burstIOPS
QoS
qosPolicyID 策略 ID,该策略中的 QoS 设置应该应用于指定卷。此参数与 qos 参数不能同时使用。 整型
setCreateTime 设置为 true 可更改所记录的卷创建日期。 布尔型
totalSize 卷的新大小(以字节为单位)。1000000000 等于 1 GB。大小将向上取整为最接近的 MB。此参数只能用于增加卷的大小。 整型
volumeIDs 要修改的卷的卷 ID 列表。 整型数组

返回值

此方法具有以下返回值:

名称 说明 类型
volume 包含每个新修改卷的相关信息的对象数组。 volume 数组

请求示例

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

{
  "method": "ModifyVolumes",
  "params": {
    "volumeIDs": [2,3],
    "attributes": {
      "name1": "value1",
      "name2": "value2",
      "name3": "value3"
    },
    "qos": {
      "minIOPS": 50,
      "maxIOPS": 100,
      "burstIOPS": 150,
      "burstTime": 60
    },
    "access" : "replicationTarget"
  },
  "totalSize": 80000000000,
  "id": 1
}

响应示例

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

{
  "id": 1,
  "result": {
    "volumes": [
      {
        "access": "replicationTarget",
        "accountID": 1,
        "attributes": {
          "name1": "value1",
          "name2": "value2",
          "name3": "value3"
        },
        "blockSize": 4096,
        "createTime": "2016-04-06T17:25:13Z",
        "deleteTime": "",
        "enable512e": false,
        "iqn": "iqn.2010-01.com.solidfire:jo73.2",
        "name": "doctest1",
        "purgeTime": "",
        "qos": {
          "burstIOPS": 150,
          "burstTime": 60,
          "curve": {
            "4096": 100,
            "8192": 160,
            "16384": 270,
            "32768": 500,
            "65536": 1000,
            "131072": 1950,
            "262144": 3900,
            "524288": 7600,
            "1048576": 15000
          },
          "maxIOPS": 100,
          "minIOPS": 50
        },
        "scsiEUIDeviceID": "6a6f373300000002f47acc0100000000",
        "scsiNAADeviceID": "6f47acc1000000006a6f373300000002",
        "sliceCount": 1,
        "status": "active",
        "totalSize": 1000341504,
        "virtualVolumeID": null,
        "volumeAccessGroups": [],
        "volumeID": 2,
        "volumePairs": []
      },
      {
        "access": "replicationTarget",
        "accountID": 1,
        "attributes": {
          "name1": "value1",
          "name2": "value2",
          "name3": "value3"
        },
        "blockSize": 4096,
        "createTime": "2016-04-06T17:26:31Z",
        "deleteTime": "",
        "enable512e": false,
        "iqn": "iqn.2010-01.com.solidfire:jo73.3",
        "name": "doctest2",
        "purgeTime": "",
        "qos": {
          "burstIOPS": 150,
          "burstTime": 60,
          "curve": {
            "4096": 100,
            "8192": 160,
            "16384": 270,
            "32768": 500,
            "65536": 1000,
            "131072": 1950,
            "262144": 3900,
            "524288": 7600,
            "1048576": 15000
          },
          "maxIOPS": 100,
          "minIOPS": 50
        },
        "scsiEUIDeviceID": "6a6f373300000003f47acc0100000000",
        "scsiNAADeviceID": "6f47acc1000000006a6f373300000003",
        "sliceCount": 1,
        "status": "active",
        "totalSize": 1000341504,
        "virtualVolumeID": null,
        "volumeAccessGroups": [],
        "volumeID": 3,
        "volumePairs": []
      }
    ]
  }
}

发布以下版本后新增

9.6