Skip to main content
Element Software
La versione in lingua italiana fornita proviene da una traduzione automatica. Per eventuali incoerenze, fare riferimento alla versione in lingua inglese.

CreateInitiator

Collaboratori

È possibile utilizzare CreateInitiators Per creare più nuovi IQN iniziatori o nomi di World Wide Port (WWPN) e, facoltativamente, assegnarli alias e attributi. Quando si utilizza CreateInitiators per creare nuovi iniziatori, è anche possibile aggiungerli ai gruppi di accesso ai volumi.

Se l'operazione non riesce a creare uno degli iniziatori forniti nel parametro, il metodo restituisce un errore e non crea alcun iniziatore (non è possibile un completamento parziale).

Parametro

Questo metodo ha il seguente parametro di input:

Nome Descrizione Tipo Valore predefinito Obbligatorio

iniziatori

Un elenco di oggetti contenente le caratteristiche di ciascun nuovo iniziatore. Oggetti:

  • alias(Facoltativo) il soprannome da assegnare a questo iniziatore. (stringa)

  • attributes(Facoltativo) un insieme di attributi JSON da assegnare a questo iniziatore. (Oggetto JSON)

  • chapUsername: (Opzionale) il nome utente CHAP univoco per questo iniziatore. Il valore predefinito è il nome dell'iniziatore (IQN) se non viene specificato durante la creazione e requireChap è true. (stringa)

  • initiatorSecret(Facoltativo) il segreto CHAP utilizzato per autenticare l'iniziatore. Il valore predefinito è un segreto generato casualmente se non specificato durante la creazione e requireChap è true. (stringa)

  • name: (Obbligatorio) il nome dell'iniziatore (IQN o WWPN) da creare. (stringa)

  • requireChap: (Opzionale) True se è richiesto CHAP durante l'accesso alla sessione per questo iniziatore. (booleano)

  • targetSecret(Facoltativo) il segreto CHAP utilizzato per autenticare la destinazione (quando si utilizza l'autenticazione CHAP reciproca). Il valore predefinito è un segreto generato casualmente se non specificato durante la creazione e requireChap è true. (stringa)

  • virtualNetworkIDs(Facoltativo) l'elenco degli identificatori di rete virtuale associati a questo iniziatore. Se si definiscono una o più reti virtuali, l'iniziatore è in grado di accedere solo a tali reti virtuali. Se non si definiscono reti virtuali, questo iniziatore può accedere a tutte le reti.

  • volumeAccessGroupID(Facoltativo) l'ID del gruppo di accesso al volume a cui verrà aggiunto l'iniziatore appena creato. (intero)

Array di oggetti JSON

Nessuno

Valore restituito

Questo metodo ha il seguente valore restituito:

Nome

Descrizione

Tipo

iniziatori

Elenco di oggetti che descrivono gli iniziatori appena creati.

iniziatore array

Errore

Questo metodo può restituire il seguente errore:

Nome

Descrizione

XInitialatorExists

Restituito se il nome dell'iniziatore scelto esiste già.

Esempio di richiesta

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

{
  "id": 3291,
  "method": "CreateInitiators",
  "params": {
    "initiators": [
      {
        "name": "iqn.1993-08.org.debian:01:288170452",
        "alias": "example1"
      },
      {
        "name": "iqn.1993-08.org.debian:01:297817012",
        "alias": "example2"
      }
    ]
  }
}

Esempio di risposta

Questo metodo restituisce una risposta simile all'esempio seguente:

{
  "id": 3291,
  "result": {
    "initiators": [
      {
        "alias": "example1",
        "attributes": {},
        "initiatorID": 145,
        "initiatorName": "iqn.1993-08.org.debian:01:288170452",
        "volumeAccessGroups": []
      },
      {
        "alias": "example2",
        "attributes": {},
        "initiatorID": 146,
        "initiatorName": "iqn.1993-08.org.debian:01:297817012",
        "volumeAccessGroups": []
      }
    ]
  }
}

Novità dalla versione

9,6

Trova ulteriori informazioni