ModifyVolumes
Mit dieser Methode können ModifyVolumes
Sie bis zu 500 vorhandene Volumes gleichzeitig konfigurieren. Änderungen finden sofort statt. Wenn ModifyVolumes
keines der angegebenen Volumes geändert werden kann, wird keines der angegebenen Volumes geändert.
Falls Sie bei dem Ändern von Volumes keine QoS-Werte angeben, bleiben die QoS-Werte für jedes Volume unverändert. Sie können die standardmäßigen QoS-Werte für ein neu erstelltes Volume abrufen, indem Sie die Methode ausführen GetDefaultQoS
.
Wenn Sie die Größe der Volumes erhöhen müssen, die repliziert werden, gehen Sie folgendermaßen vor, um Replizierungsfehler zu vermeiden:
-
Erhöhen Sie die Größe des Volumes mit replizierungTarget-Zugriff.
-
Erhöhen Sie die Größe des Quell- oder Volume mit ReadWrite-Zugriff.
Stellen Sie sicher, dass sowohl die Ziel- als auch die Quell-Volumes dieselbe Größe haben.
Wenn Sie den Zugriffsstatus in gesperrt oder ReplikationTarget ändern, werden alle vorhandenen iSCSI-Verbindungen beendet. |
Parameter
Diese Methode verfügt über die folgenden Eingabeparameter:
Name |
Beschreibung |
Typ |
Standardwert |
Erforderlich |
Datenzugriff |
Zugriff für die Volumes zulässig. Mögliche Werte:
|
Zeichenfolge |
Keine |
Nein |
AccountID |
Die AccountID, der die Volumes neu zugeordnet werden. Wenn keine angegeben wird, wird der vorherige Kontoname verwendet. |
Ganzzahl |
Keine |
Nein |
AssoziateWithQoSPolicy |
Verknüpfen Sie das Volume mit der angegebenen QoS-Richtlinie. Mögliche Werte:
|
boolesch |
Keine |
Nein |
Merkmale |
Liste von Name-Wert-Paaren im JSON-Objektformat. |
JSON Objekt |
Keine |
Nein |
CreateTime |
Eine ISO 8601-Datumszeichenfolge, die als Erstellungsdatum des neuen Volumes festgelegt werden soll. Erforderlich, wenn setCreateTime auf true gesetzt ist. |
ISO 8601-Zeichenfolge |
Keine |
Nein |
AbleSnapMirrorReplication |
Legt fest, ob das Volume für die Replizierung mit SnapMirror Endpunkten verwendet werden kann. Mögliche Werte:
|
boolesch |
Falsch |
Nein |
FifoGröße |
Gibt die maximale Anzahl von FIFO-Snapshots an, die vom Volume unterstützt werden. Beachten Sie, dass FIFO- und nicht-FIFO-Snapshots beide denselben Pool verfügbarer Snapshot-Steckplätze auf einem Volume nutzen. Verwenden Sie diese Option, um den FIFO-Snapshot-Verbrauch der verfügbaren Snapshot-Steckplätze zu begrenzen. Beachten Sie, dass Sie diesen Wert nicht so ändern können, dass er kleiner als die aktuelle FIFO-Snapshot-Anzahl ist. |
Ganzzahl |
Keine |
Nein |
Min50 Größe |
Gibt die Anzahl der Snapshot-Steckplätze an, die nur für FIFO-Snapshots (First in First out) reserviert sind. Da FIFO- und nicht-FIFO-Snapshots sich den gleichen Pool teilen, reduziert der minFifoSize-Parameter die Gesamtzahl der möglichen Non-FIFO-Schnappschüsse um die gleiche Menge. Beachten Sie, dass Sie diesen Wert nicht ändern können, damit er mit der aktuellen Anzahl nicht-FIFO-Snapshots in Konflikt steht. |
Ganzzahl |
Keine |
Nein |
Modus |
Volume-Replizierungsmodus Mögliche Werte:
|
Zeichenfolge |
Keine |
Nein |
qos |
Die neue Quality-of-Service-Einstellungen für die Volumes. Wenn nicht angegeben, werden die QoS-Einstellungen nicht geändert. Mögliche Werte:
|
Keine |
Nein |
|
QosPolicyID |
Die ID für die Richtlinie, deren QoS-Einstellungen auf die angegebenen Volumes angewendet werden sollten. Dieser Parameter schließen sich gegenseitig mit dem qos-Parameter aus. |
Ganzzahl |
Keine |
Nein |
SetCreateTime |
Setzen Sie auf true, um das aufgezeichnete Datum der Volume-Erstellung zu ändern. |
boolesch |
Keine |
Nein |
Summengröße |
Die neue Größe der Volumen in Byte. 1000000000 entspricht 1 GB. Die Größe wird auf den nächsten Megabyte aufgerundet. Mit diesem Parameter kann nur die Größe eines Volumes erhöht werden. |
Ganzzahl |
Keine |
Nein |
VolumeIDs |
Eine Liste der VolumeIDs der zu ändernden Volumes |
Integer-Array |
Keine |
Ja. |
Rückgabewert
Diese Methode hat den folgenden Rückgabewert:
Name |
Beschreibung |
Typ |
Datenmenge |
Ein Array von Objekten, die Informationen zu jedem neu geänderten Volume enthalten. |
Datenmenge Array |
Anforderungsbeispiel
Anforderungen für diese Methode sind ähnlich wie das folgende Beispiel:
{ "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 }
Antwortbeispiel
Diese Methode gibt eine Antwort zurück, die dem folgenden Beispiel ähnelt:
{ "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": [] } ] } }
Neu seit Version
9,6