ModifyVolumeAccessGroup
Sie können die Methode verwenden ModifyVolumeAccessGroup
, um Initiatoren zu aktualisieren und Volumes zu einer Volume-Zugriffsgruppe hinzuzufügen oder zu entfernen.
Wenn ein angegebener Initiator oder Volume eine Duplizierung der derzeitigen vorhanden ist, bleibt die Volume-Zugriffsgruppe ohne den ist-Wert. Wenn Sie keinen Wert für Volumes oder Initiatoren angeben, wird die aktuelle Liste der Initiatoren und Volumes nicht geändert.
Parameter
Diese Methode verfügt über die folgenden Eingabeparameter:
Name |
Beschreibung |
Typ |
Standardwert |
Erforderlich |
VolumeAccessGroupID |
Die ID der zu ändernden Volume-Zugriffsgruppe. |
Ganzzahl |
Keine |
Ja. |
Name |
Der neue Name für diese Zugriffsgruppe. |
Zeichenfolge |
Keine |
Nein |
Merkmale |
Liste von Name-Wert-Paaren im JSON-Objektformat. |
JSON Objekt |
Keine |
Nein |
Initiatoren |
Liste der Initiator-IDs oder Namen (IQNs und WWPNs), die in die Volume-Zugriffsgruppe aufgenommen werden sollen Wenn Sie eine Liste der Initiatornamen übergeben, werden die Initiatoren erstellt, wenn sie noch nicht vorhanden sind. Wenn Sie eine Liste der Initiator-IDs übergeben, gibt die Methode einen Fehler aus, wenn einer der Initiatoren nicht bereits vorhanden ist. Die Weitergabe von Initiatorgruppen ist veraltet. Sie sollten Initiator-IDs verwenden, sobald möglich. |
Integer-Array (empfohlen) oder String-Array (veraltet) |
Keine |
Nein |
DeleteOrphanInitiatoren |
Gibt an, ob Objekte gelöscht werden, nachdem sie aus einer Volume-Zugriffsgruppe entfernt wurden oder nicht. Mögliche Werte:
|
boolesch |
Falsch |
Nein |
Volumes |
Liste der zu ändernden Volume-IDs |
Integer-Array |
Keine |
Rückgabewert
Diese Methode hat den folgenden Rückgabewert:
Name |
Beschreibung |
Typ |
VolumeAccessGroup |
Ein Objekt mit Informationen über die neu geänderte Volume-Zugriffsgruppe. |
Anforderungsbeispiel
Anforderungen für diese Methode sind ähnlich wie das folgende Beispiel:
{ "method": "ModifyVolumeAccessGroup", "params": { "volumeAccessGroupID": 96, "name": "accessgrouptest", "initiators": [115,114], "volumes": [ 346 ], "attributes": {} } }
Antwortbeispiel
Diese Methode gibt eine Antwort zurück, die dem folgenden Beispiel ähnelt:
{ "id": null, "result": { "volumeAccessGroup": { "attributes": {}, "deletedVolumes": [ 327 ], "initiatorIDs": [ 114, 115 ], "initiators": [ "iqn.1998-01.com.vmware:desk1-esx1-577b283a", "iqn.1998-01.com.vmware:donesq-esx1-421b281b" ], "name": "accessgrouptest", "volumeAccessGroupID": 96, "volumes": [ 346 ] } } }
Neu seit Version
9,6