ModifyVolumes
建议更改
PDF
您可以使用 `ModifyVolumes`方法一次最多配置500个现有卷。更改将立即生效。如果 `ModifyVolumes`无法修改任何指定卷、则所有指定卷都不会发生更改。
如果在修改卷时未指定 QoS 值，则每个卷的 QoS 值保持不变。您可以通过运行方法来检索新创建卷的默认QoS值 GetDefaultQoS。
如果需要增加要复制的卷的大小，请按以下顺序执行此操作，以防止出现复制错误：
-
增加具有 replicationTarget 访问权限的卷的大小。
-
增加具有读写访问权限的源或卷的大小。
确保目标卷和源卷的大小相同。
|
如果将访问状态更改为 locked 或 replicationTarget ，则所有现有 iSCSI 连接都将终止。 |
参数
此方法具有以下输入参数：
名称 |
说明 |
键入 |
默认值 |
必填 |
访问 |
允许对卷进行访问。可能值：
|
string |
无 |
否 |
帐户ID |
将卷重新分配到的帐户 ID 。如果未指定任何帐户，则会使用先前的帐户名称。 |
整型 |
无 |
否 |
associateWithQoSPolicy |
将卷与指定的 QoS 策略相关联。可能值：
|
boolean |
无 |
否 |
属性 |
名称 - 值对列表，采用 JSON 对象格式。 |
JSON 对象 |
无 |
否 |
CREATETIME |
要设置为新卷创建日期的 ISO 8601 日期字符串。如果 setCreateTime 设置为 true ，则为必需项。 |
ISO 8601 字符串 |
无 |
否 |
启用 SnapMirrorReplication |
确定卷是否可用于 SnapMirror 端点的复制。可能值：
|
boolean |
false |
否 |
五个大小 |
指定卷支持的最大先出（ FIFO ）快照数。请注意， FIFO 快照和非 FIFO 快照都使用卷上相同的可用快照插槽池。使用此选项可限制可用快照插槽的 FIFO 快照消耗量。请注意，您不能将此值修改为小于当前的 FIFO 快照计数。 |
整型 |
无 |
否 |
最小大小 |
指定仅为先出（ First-in-First-out ， FIFO ）快照预留的快照插槽数量。由于 FIFO 和非 FIFO 快照共享同一个池，因此 minFIFO 参数会将可能的非 FIFO 快照总数减少相同的量。请注意，您不能修改此值，使其与当前非 FIFO 快照计数冲突。 |
整型 |
无 |
否 |
模式 |
卷复制模式。可能值：
|
string |
无 |
否 |
QoS |
卷的新服务质量设置。如果未指定，则不会更改 QoS 设置。可能值：
|
无 |
否 |
|
qosPolicyID |
应将 QoS 设置应用于指定卷的策略的 ID 。此参数与 QoS 参数不能共存。 |
整型 |
无 |
否 |
setCreateTime |
设置为 true 可更改记录的卷创建日期。 |
boolean |
无 |
否 |
totalSize |
卷的新大小（以字节为单位）。1000000000 等于 1 GB 。大小将向上取整为最接近的兆字节大小。此参数只能用于增加卷的大小。 |
整型 |
无 |
否 |
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