CreateVolumeAccessGroup
Verwenden Sie können CreateVolumeAccessGroup So erstellen Sie eine neue Zugriffsgruppe für Volumes: Wenn Sie die Volume-Zugriffsgruppe erstellen, müssen Sie ihr einen Namen geben und optional Initiatoren und Volumes eingeben.
Jeder Initiator-IQN, den Sie der Volume Access Group hinzufügen, kann ohne CHAP-Authentifizierung auf beliebige Volumes in der Gruppe zugreifen.
|
|
Geklonte Volumes übernehmen keine Zugriffsgruppenmitgliedschaft für Volumes vom Quell-Volume. |
Bei der Erstellung von Volume-Zugriffsgruppen ist Folgendes zu beachten:
-
Eine Volume-Zugriffsgruppe kann bis zu 64 Initiator-IQNs enthalten.
-
Ein Initiator kann nur zu einer Volume-Zugriffsgruppe gehören.
-
Eine Volume-Zugriffsgruppe kann bis zu 2000 Volumes enthalten.
-
Jede Volume-Zugriffsgruppe kann zu maximal vier Volume-Zugriffsgruppen gehören.
Parameter
Diese Methode verfügt über 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 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 oder String-Array (veraltet) |
Nein |
|
Name |
Name der Zugriffsgruppe für Volumes. Nicht unbedingt eindeutig, aber empfohlen. Muss 1 bis 64 Zeichen lang sein. |
Zeichenfolge |
Keine |
Ja. |
Volumes |
Liste der Volume-IDs, die in die Volume-Zugriffsgruppe einbezogen werden sollen |
Integer-Array |
Nein |
|
Merkmale |
Liste von Name-Wert-Paaren im JSON-Objektformat. |
JSON-Objekt |
{} |
Nein |
Rückgabewerte
Diese Methode verfügt über die folgenden Rückgabewerte:
Name |
Beschreibung |
Typ |
VolumeAccessGroup |
Ein Objekt, das Informationen über die neu erstellte Volume-Zugriffsgruppe enthält. |
|
VolumeAccessGroupID |
Die ID der neu erstellten Volume Zugriffsgruppe. |
Ganzzahl |
Anforderungsbeispiel
Anforderungen für diese Methode sind ähnlich wie das folgende Beispiel:
{
"method": "CreateVolumeAccessGroup",
"params": {
"name": "myaccessgroup",
"initiators": ["iqn.1993-08.org.debian: 01: a31b1d799d5c"],
"volumes": [327],
"attributes": {}
}
}
Antwortbeispiel
Diese Methode gibt eine Antwort zurück, 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