Skip to main content
Element Software
Eine neuere Version dieses Produkts ist erhältlich.
Die deutsche Sprachversion wurde als Serviceleistung für Sie durch maschinelle Übersetzung erstellt. Bei eventuellen Unstimmigkeiten hat die englische Sprachversion Vorrang.

CreateInitiatoren

Beitragende
PDFs

Sie können zum Erstellen mehrerer neuer Initiator-IQNs oder World Wide Port Names (WWPNs) verwenden CreateInitiators und diese optional Aliase und Attribute zuweisen. Wenn Sie zum Erstellen neuer Initiatoren verwenden CreateInitiators, können Sie sie auch Volume-Zugriffsgruppen hinzufügen.

Wenn der Vorgang einen der im Parameter angegebenen Initiatoren nicht erstellt, gibt die Methode einen Fehler aus und erstellt keine Initiatoren (ein partieller Abschluss ist nicht möglich).

Parameter

Diese Methode verfügt über den folgenden Eingabeparameter:

Name Beschreibung Typ Standardwert Erforderlich

Initiatoren

Eine Liste von Objekten, die die Eigenschaften der einzelnen neuen Initiatoren enthalten. Objekte:

  • alias: (Optional) der Name, der diesem Initiator zugewiesen werden soll. (Zeichenfolge)

  • attributes: (Optional) Eine Reihe von JSON-Attributen, die diesem Initiator zugewiesen werden sollen. (JSON-Objekt)

  • chapUsername: (Optional) der eindeutige CHAP-Benutzername für diesen Initiator. Setzt den Initiatornamen (IQN) standardmäßig ein, wenn er während der Erstellung nicht angegeben wurde und requiredChap wahr ist. (Zeichenfolge)

  • initiatorSecret: (Optional) der CHAP-Schlüssel, der zur Authentifizierung des Initiators verwendet wird. Die Standardeinstellung ist ein zufällig generiertes Geheimnis, wenn es während der Erstellung nicht angegeben wurde und requiredChap wahr ist. (Zeichenfolge)

  • name: (Erforderlich) der Name des zu erstellenden Initiators (IQN oder WWPN). (Zeichenfolge)

  • requireChap: (Optional) true wenn CHAP während der Session-Anmeldung für diesen Initiator erforderlich ist. (boolesch)

  • targetSecret: (Optional) der CHAP-Schlüssel, der zur Authentifizierung des Ziels verwendet wird (bei Verwendung der gegenseitigen CHAP-Authentifizierung). Die Standardeinstellung ist ein zufällig generiertes Geheimnis, wenn es während der Erstellung nicht angegeben wurde und requiredChap wahr ist. (Zeichenfolge)

  • virtualNetworkIDs: (Optional) Liste der virtuellen Netzwerkkennungen, die mit diesem Initiator verknüpft sind. Wenn Sie ein oder mehrere virtuelle Netzwerke definieren, kann sich dieser Initiator nur bei diesen virtuellen Netzwerken anmelden. Wenn Sie keine virtuellen Netzwerke definieren, kann sich dieser Initiator bei allen Netzwerken anmelden.

  • volumeAccessGroupID: (Optional) die ID der Zugriffsgruppe des Volumes, der dieser neu erstellte Initiator hinzugefügt wird. (Ganze Zahl)

JSON-Objekt-Array

Keine

Ja.

Rückgabewert

Diese Methode hat den folgenden Rückgabewert:

Name

Beschreibung

Typ

Initiatoren

Liste von Objekten, die die neu erstellten Initiatoren beschreiben

Initiator Array

Fehler

Mit dieser Methode kann der folgende Fehler zurückgegeben werden:

Name

Beschreibung

XInitiatorExists

Dieser Wert wird zurückgegeben, wenn der ausgewählte Name des Initiators bereits vorhanden ist.

Anforderungsbeispiel

Anforderungen für diese Methode sind ähnlich wie das folgende Beispiel:

{
  "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"
      }
    ]
  }
}

Antwortbeispiel

Diese Methode gibt eine Antwort zurück, die dem folgenden Beispiel ähnelt:

{
  "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": []
      }
    ]
  }
}

Neu seit Version

9,6

Weitere Informationen

ListenInitiatoren