CreateVolumeAccessGroup
Sie können verwenden CreateVolumeAccessGroup um eine neue Datenträgerzugriffsgruppe zu erstellen. Beim Erstellen der Volume-Zugriffsgruppe müssen Sie ihr einen Namen geben und können optional Initiatoren und Volumes eingeben.
Jeder Initiator-IQN, den Sie der Volume-Zugriffsgruppe hinzufügen, kann ohne CHAP-Authentifizierung auf jedes Volume in der Gruppe zugreifen.
|
|
Geklonte Volumes erben die Zugehörigkeit zu den Volume-Zugriffsgruppen nicht vom Quellvolume. |
Beachten Sie Folgendes beim Erstellen von Datenträgerzugriffsgruppen:
-
Eine Volume-Zugriffsgruppe kann bis zu 64 Initiator-IQNs enthalten.
-
Ein Initiator kann nur einer Volume-Zugriffsgruppe angehören.
-
Eine Volume-Zugriffsgruppe kann bis zu 2000 Volumes enthalten.
-
Jede Datenträgerzugriffsgruppe kann maximal vier Datenträgerzugriffsgruppen angehören.
Parameter
Diese Methode hat die folgenden Eingabeparameter:
| Name | Beschreibung | Typ | Standardwert | Erforderlich |
|---|---|---|---|---|
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 oder Zeichenketten-Array (veraltet) |
Nein |
|
Name |
Name der Datenträgerzugriffsgruppe. Es ist nicht erforderlich, dass es einzigartig ist, aber empfehlenswert. Muss zwischen 1 und 64 Zeichen lang sein. |
Schnur |
Keine |
Ja |
Bände |
Liste der Volume-IDs, die in die Volume-Zugriffsgruppe aufgenommen werden sollen. |
Ganzzahl-Array |
Nein |
|
Attribute |
Liste von Name-Wert-Paaren im JSON-Objektformat. |
JSON-Objekt |
{} |
Nein |
Rückgabewerte
Diese Methode hat die folgenden Rückgabewerte:
Name |
Beschreibung |
Typ |
volumeAccessGroup |
Ein Objekt, das Informationen über die neu erstellte Datenträgerzugriffsgruppe enthält. |
|
volumeAccessGroupID |
Die ID der neu erstellten Datenträgerzugriffsgruppe. |
ganze Zahl |
Anforderungsbeispiel
Anfragen für diese Methode ähneln dem folgenden Beispiel:
{
"method": "CreateVolumeAccessGroup",
"params": {
"name": "myaccessgroup",
"initiators": ["iqn.1993-08.org.debian: 01: a31b1d799d5c"],
"volumes": [327],
"attributes": {}
}
}
Antwortbeispiel
Diese Methode liefert eine Antwort, die dem folgenden Beispiel ähnelt:
{
"id": null,
"result": {
"volumeAccessGroup": {
"attributes": {},
"deletedVolumes": [],
"initiatorIDs": [
95
],
"initiators": [
"iqn.1993-08.org.debian: 01: a31b1d799d5c"
],
"name": "myaccessgroup",
"volumeAccessGroupID": 96,
"volumes": [
327
]
},
"volumeAccessGroupID": 96
}
}
Neu seit Version
9,6