ModifyVolumeAccessGroup
Sie können die ModifyVolumeAccessGroup Methode zum Aktualisieren von Initiatoren und zum Hinzufügen oder Entfernen von Volumes aus einer Volume-Zugriffsgruppe.
Wenn ein bestimmter Initiator oder ein bestimmtes Volume ein Duplikat eines bereits vorhandenen ist, bleibt die Volume-Zugriffsgruppe unverändert. Wenn Sie keinen Wert für Volumes oder Initiatoren angeben, bleibt die aktuelle Liste der Initiatoren und Volumes unverändert.
Parameter
Diese Methode hat die folgenden Eingabeparameter:
Name |
Beschreibung |
Typ |
Standardwert |
Erforderlich |
volumeAccessGroupID |
Die ID der zu ändernden Datenträgerzugriffsgruppe. |
ganze Zahl |
Keine |
Ja |
Name |
Der neue Name für diese Datenträgerzugriffsgruppe. |
Schnur |
Keine |
Nein |
Attribute |
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 von Initiatornamen übergeben, werden die Initiatoren erstellt, sofern sie noch nicht existieren. Wenn Sie eine Liste von Initiator-IDs übergeben, gibt die Methode einen Fehler zurück, falls einer der Initiatoren noch nicht existiert. Die Übergabe von Initiatornamen ist veraltet; verwenden Sie nach Möglichkeit Initiator-IDs. |
Ganzzahl-Array (empfohlen) oder Zeichenketten-Array (veraltet) |
Keine |
Nein |
deleteOrphanInitiators |
Legt fest, ob Initiatorobjekte nach dem Entfernen aus einer Volume-Zugriffsgruppe gelöscht werden sollen oder nicht. Mögliche Werte:
|
boolescher Wert |
FALSCH |
Nein |
Bände |
Eine Liste der Datenträger-IDs der zu ändernden Datenträger. |
Ganzzahl-Array |
Keine |
Rückgabewert
Diese Methode hat folgenden Rückgabewert:
Name |
Beschreibung |
Typ |
volumeAccessGroup |
Ein Objekt, das Informationen über die neu geänderte Datenträgerzugriffsgruppe enthält. |
Anforderungsbeispiel
Anfragen für diese Methode ähneln dem folgenden Beispiel:
{
"method": "ModifyVolumeAccessGroup",
"params": {
"volumeAccessGroupID": 96,
"name": "accessgrouptest",
"initiators": [115,114],
"volumes": [
346
],
"attributes": {}
}
}
Antwortbeispiel
Diese Methode liefert eine Antwort, 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