简体中文版经机器翻译而成，仅供参考。如与英语版出现任何冲突，应以英语版为准。

ModifyVolumes

02/10/2025 贡献者

PDF

您可以使用 ModfyVolumes 方法一次最多配置 500 个现有卷。更改将立即生效。如果 MmodifyVolumes 无法修改任何指定卷，则指定卷均不会更改。

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

如果需要增加要复制的卷的大小，请按以下顺序执行此操作，以防止出现复制错误：

增加具有 replicationTarget 访问权限的卷的大小。
增加具有读写访问权限的源或卷的大小。

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

如果将访问状态更改为 locked 或 replicationTarget ，则所有现有 iSCSI 连接都将终止。

Parameters

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

Name Description Type 默认值 Required

Name	Description	Type	默认值	Required
访问	允许对卷进行访问。可能值： `readOnly` ：仅允许执行读取操作。 `readWrite` ：允许读取和写入。 `locked` ：不允许读取或写入。如果未指定，则访问值不会更改。 `replicationTarget` ：将卷标识为一组配对卷的目标卷。如果卷未配对，则访问状态为 locked 。如果未指定值，则访问值不会更改。	string	无	否
accountId	将卷重新分配到的帐户 ID 。如果未指定任何帐户，则会使用先前的帐户名称。	整型	无	否
associateWithQoSPolicy	将卷与指定的 QoS 策略相关联。可能值： `true` ：将卷与 QoSPolicyID 参数中指定的 QoS 策略关联。 `false` ：不要将卷与 QoSPolicyID 参数中指定的 QoS 策略相关联。如果为 false ，则无论是否在 QoSPolicy 参数中指定 QoS 策略，都会删除任何现有策略关联。	boolean	无	否
属性	名称 - 值对列表，采用 JSON 对象格式。	JSON 对象	无	否
CREATETIME	要设置为新卷创建日期的 ISO 8601 日期字符串。如果 setCreateTime 设置为 true ，则为必需项。	ISO 8601 字符串	无	否
DontMoveforIops重新平衡	使用实际IOPS进行负载平衡时、防止卷移动。从Element 12.8开始、此设置可用、并且仅在启用时生效"卷LoadBalanceOn实际IOPS"。可能值： `true`：卷不会根据实际IOPS进行负载平衡。 `false`：卷会根据实际IOPS进行负载平衡。注意：为实现高可用性(节点故障)而进行的平衡优先于 VolumeLoadBalanceOnActualIOPS`和 `dontMoveforIopsRebalance。	boolean	false	否
启用 SnapMirrorReplication	确定卷是否可用于 SnapMirror 端点的复制。可能值： `true` `false`	boolean	false	否
五个大小	指定卷支持的最大先出（ FIFO ）快照数。请注意， FIFO 快照和非 FIFO 快照都使用卷上相同的可用快照插槽池。使用此选项可限制可用快照插槽的 FIFO 快照消耗量。请注意，您不能将此值修改为小于当前的 FIFO 快照计数。	整型	无	否
最小大小	指定仅为先出（ First-in-First-out ， FIFO ）快照预留的快照插槽数量。由于 FIFO 和非 FIFO 快照共享同一个池，因此 minFIFO 参数会将可能的非 FIFO 快照总数减少相同的量。请注意，您不能修改此值，使其与当前非 FIFO 快照计数冲突。	整型	无	否
模式	卷复制模式。可能值： `asynch` ：等待系统确认数据存储在源上，然后再写入目标。 `sync` ：不等待源的数据传输确认开始向目标写入数据。	string	无	否
QoS	卷的新服务质量设置。如果未指定，则不会更改 QoS 设置。可能值： `minIOPS` `maxIOPS` `突发 IOPS`	QoS	无	否
qosPolicyID	应将 QoS 设置应用于指定卷的策略的 ID 。此参数与 QoS 参数不能共存。	整型	无	否
setCreateTime	设置为 true 可更改记录的卷创建日期。	boolean	无	否
totalSize	卷的新大小（以字节为单位）。1000000000 等于 1 GB 。大小将向上取整为最接近的兆字节大小。此参数只能用于增加卷的大小。	整型	无	否
volumeIds	要修改的卷的卷 ID 列表。	整型数组	无	是的。

访问

允许对卷进行访问。可能值：

readOnly ：仅允许执行读取操作。
readWrite ：允许读取和写入。
locked ：不允许读取或写入。如果未指定，则访问值不会更改。
replicationTarget ：将卷标识为一组配对卷的目标卷。如果卷未配对，则访问状态为 locked 。如果未指定值，则访问值不会更改。

string

无

否

accountId

将卷重新分配到的帐户 ID 。如果未指定任何帐户，则会使用先前的帐户名称。

整型

无

否

associateWithQoSPolicy

将卷与指定的 QoS 策略相关联。可能值：

true ：将卷与 QoSPolicyID 参数中指定的 QoS 策略关联。
false ：不要将卷与 QoSPolicyID 参数中指定的 QoS 策略相关联。如果为 false ，则无论是否在 QoSPolicy 参数中指定 QoS 策略，都会删除任何现有策略关联。

boolean

无

否

属性

名称 - 值对列表，采用 JSON 对象格式。

JSON 对象

无

否

CREATETIME

要设置为新卷创建日期的 ISO 8601 日期字符串。如果 setCreateTime 设置为 true ，则为必需项。

ISO 8601 字符串

无

否

DontMoveforIops重新平衡

使用实际IOPS进行负载平衡时、防止卷移动。从Element 12.8开始、此设置可用、并且仅在启用时生效"卷LoadBalanceOn实际IOPS"。可能值：

true：卷不会根据实际IOPS进行负载平衡。
false：卷会根据实际IOPS进行负载平衡。

注意：为实现高可用性(节点故障)而进行的平衡优先于 VolumeLoadBalanceOnActualIOPS`和 `dontMoveforIopsRebalance。

boolean

false

否

启用 SnapMirrorReplication

确定卷是否可用于 SnapMirror 端点的复制。可能值：

true
false

boolean

false

否

五个大小

指定卷支持的最大先出（ FIFO ）快照数。请注意， FIFO 快照和非 FIFO 快照都使用卷上相同的可用快照插槽池。使用此选项可限制可用快照插槽的 FIFO 快照消耗量。请注意，您不能将此值修改为小于当前的 FIFO 快照计数。

整型

无

否

最小大小

指定仅为先出（ First-in-First-out ， FIFO ）快照预留的快照插槽数量。由于 FIFO 和非 FIFO 快照共享同一个池，因此 minFIFO 参数会将可能的非 FIFO 快照总数减少相同的量。请注意，您不能修改此值，使其与当前非 FIFO 快照计数冲突。

整型

无

否

模式

卷复制模式。可能值：

asynch ：等待系统确认数据存储在源上，然后再写入目标。
sync ：不等待源的数据传输确认开始向目标写入数据。

string

无

否

QoS

卷的新服务质量设置。如果未指定，则不会更改 QoS 设置。可能值：

minIOPS
maxIOPS
突发 IOPS

QoS

无

否

qosPolicyID

应将 QoS 设置应用于指定卷的策略的 ID 。此参数与 QoS 参数不能共存。

整型

无

否

setCreateTime

设置为 true 可更改记录的卷创建日期。

boolean

无

否

totalSize

卷的新大小（以字节为单位）。1000000000 等于 1 GB 。大小将向上取整为最接近的兆字节大小。此参数只能用于增加卷的大小。

整型

无

否

volumeIds

要修改的卷的卷 ID 列表。

整型数组

无

是的。

返回值

此方法具有以下返回值：

Name	Description	Type
volume	一个对象数组，其中包含有关每个新修改的卷的信息。	volume 数组

Name

Description

Type

volume

一个对象数组，其中包含有关每个新修改的卷的信息。

volume 数组

请求示例

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

{
  "method": "ModifyVolumes",
  "params": {
    "volumeIDs": [319,22],
    "access": "readWrite",
    "dontMoveForIopsRebalance": false
  },
  "id": 1
}

响应示例

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

{
  "id": 1,
  "result": {
    "volumes":
      {
        "access":  "readWrite,
        "accountID": 22,
        "attributes": {},
        "blockSize": 4096,
        "createTime": "2024-04-01T19:39:40Z",
        "currentProtectionScheme": "doubleHelix",
        "deleteTime": "",
        "dontMoveForIopsRebalance": false,
        "enable512e": false,
        "enableSnapMirrorReplication": false,
        "fifoSize": 24,
        "iqn": "iqn.2010-01.com.solidfire:3eeu.suite40.319",
        "lastAccessTime": "2024-04-02T12:41:34Z",
        "lastAccessTimeIO": "2024-04-01T20:41:19Z",
        "minFifoSize": 0,
        "name": "suite40",
        "previousProtectionScheme": null,
        "purgeTime": "",
        "qos": {
          "burstIOPS": 27000,
          "burstTime": 60,
          "curve": {
            "1048576": 15000,
            "131072": 1950,
            "16384": 270,
            "262144": 3900,
            "32768": 500,
            "4096": 100,
            "524288": 7600,
            "65536": 1000,
            "8192": 160
          },
          "maxIOPS": 27000,
          "minIOPS": 500
        },
        "qosPolicyID": null,
        "scsiEUIDeviceID": "336565750000013ff47acc0100000000",
        "scsiNAADeviceID": "6f47acc100000000336565750000013f",
        "sliceCount": 1,
        "status": "active",
        "totalSize": 1000000716800,
        "virtualVolumeID": null,
        "volumeAccessGroups": [
        22
        ],
        "volumeConsistencyGroupUUID": "3003109e-6e75-444c-8cee-470d641a09c3",
        "volumeID": 319,
        "volumePairs": [],
        "
      }
  }
}

自版本以来的新增功能

9.6

了解更多信息

GetDefaultQoS

ModifyVolumes

Creating your file...

Parameters

返回值

请求示例

响应示例

自版本以来的新增功能

了解更多信息