La versione in lingua italiana fornita proviene da una traduzione automatica. Per eventuali incoerenze, fare riferimento alla versione in lingua inglese.

CreateVolumeAccessGroup

05/23/2023 Collaboratori

PDF

È possibile utilizzare CreateVolumeAccessGroup per creare un nuovo gruppo di accesso al volume. Quando si crea il gruppo di accesso al volume, è necessario assegnargli un nome e, facoltativamente, è possibile inserire iniziatori e volumi.

Qualsiasi IQN iniziatore aggiunto al gruppo di accesso al volume può accedere a qualsiasi volume del gruppo senza autenticazione CHAP.

I volumi clonati non ereditano l'appartenenza al gruppo di accesso al volume dal volume di origine.

Quando si creano gruppi di accesso ai volumi, considerare quanto segue:

Un gruppo di accesso al volume può contenere fino a 64 IQN iniziatori.
Un iniziatore può appartenere a un solo gruppo di accesso al volume.
Un gruppo di accesso al volume può contenere fino a 2000 volumi.
Ciascun gruppo di accesso al volume può appartenere a un massimo di quattro gruppi di accesso al volume.

Parametri

Questo metodo ha i seguenti parametri di input:

Nome	Descrizione	Tipo	Valore predefinito	Obbligatorio
iniziatori	Elenco degli ID o dei nomi degli iniziatori (IQN e WWPN) da includere nel gruppo di accesso al volume. Se si passa un elenco di nomi di iniziatori, gli iniziatori vengono creati se non esistono già. Se si passa un elenco di ID iniziatore, il metodo restituisce un errore se uno degli iniziatori non esiste già. Il passaggio dei nomi degli iniziatori è obsoleto; se possibile, è necessario utilizzare gli ID degli iniziatori.	array intero o array di stringhe (obsoleto)		No
nome	Nome del gruppo di accesso al volume. Non è necessario essere unici, ma consigliato. La lunghezza deve essere compresa tra 1 e 64 caratteri.	stringa	Nessuno	Sì
volumi	Elenco dei volumeID da includere nel gruppo di accesso al volume.	array intero		No
attributi	Elenco delle coppie nome-valore nel formato oggetto JSON.	Oggetto JSON	{}	No

Nome

Descrizione

Tipo

Valore predefinito

Obbligatorio

iniziatori

Elenco degli ID o dei nomi degli iniziatori (IQN e WWPN) da includere nel gruppo di accesso al volume. Se si passa un elenco di nomi di iniziatori, gli iniziatori vengono creati se non esistono già. Se si passa un elenco di ID iniziatore, il metodo restituisce un errore se uno degli iniziatori non esiste già. Il passaggio dei nomi degli iniziatori è obsoleto; se possibile, è necessario utilizzare gli ID degli iniziatori.

array intero o array di stringhe (obsoleto)

nome

Nome del gruppo di accesso al volume. Non è necessario essere unici, ma consigliato. La lunghezza deve essere compresa tra 1 e 64 caratteri.

stringa

Nessuno

Sì

volumi

Elenco dei volumeID da includere nel gruppo di accesso al volume.

array intero

attributi

Elenco delle coppie nome-valore nel formato oggetto JSON.

Oggetto JSON

{}

Valori restituiti

Questo metodo ha i seguenti valori restituiti:

Nome

Descrizione

Tipo

VolumeAccessGroup

Oggetto contenente informazioni sul gruppo di accesso al volume appena creato.

VolumeAccessGroup

VolumeAccessGroupID

L'ID del gruppo di accesso al volume appena creato.

intero

Esempio di richiesta

Le richieste per questo metodo sono simili all'esempio seguente:

{
   "method": "CreateVolumeAccessGroup",
   "params": {
      "name": "myaccessgroup",
      "initiators": ["iqn.1993-08.org.debian: 01: a31b1d799d5c"],
      "volumes": [327],
      "attributes": {}
   }
}

Esempio di risposta

Questo metodo restituisce una risposta simile all'esempio seguente:

{
  "id": null,
  "result": {
    "volumeAccessGroup": {
      "attributes": {},
      "deletedVolumes": [],
      "initiatorIDs": [
        95
      ],
      "initiators": [
        "iqn.1993-08.org.debian: 01: a31b1d799d5c"
      ],
      "name": "myaccessgroup",
      "volumeAccessGroupID": 96,
      "volumes": [
        327
      ]
    },
    "volumeAccessGroupID": 96
  }
}

Novità dalla versione

9.6