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.

ModifyInitiatoren

Beitragende
PDFs

Sie können die Methode verwenden ModifyInitiators, um die Attribute eines oder mehrerer vorhandener Initiatoren zu ändern.

Sie können den Namen eines vorhandenen Initiators nicht ändern. Wenn Sie den Namen eines Initiators ändern müssen, löschen Sie ihn zunächst mit der Methode, und erstellen Sie einen neuen Initiator DeleteInitiatorenmit der CreateInitiatoren Methode.

Wenn ModityInitiatoren einen der im Parameter angegebenen Initiatoren nicht ändern können, gibt die Methode einen Fehler zurück und ändert keine Initiatoren (kein Teilabschluss möglich).

Parameter

Diese Methode verfügt über den folgenden Eingabeparameter:

Name

Beschreibung

Typ

Standardwert

Erforderlich

Initiatoren

Eine Liste der Objekte, die die Merkmale der einzelnen zu ändernden Initiatoren enthalten. Mögliche Objekte:

  • alias: (Optional) Ein neuer Anzeigename, der dem Initiator zugewiesen werden soll. (Zeichenfolge)

  • attributes: (Optional) Ein neuer Satz JSON-Attribute, der dem Initiator zugewiesen werden soll. (JSON-Objekt)

  • chapUsername: (Optional) Ein neuer eindeutiger CHAP-Benutzername für diesen Initiator. (Zeichenfolge)

  • forceDuringUpgrade: Vervollständigen Sie die Änderung des Initiators während eines Upgrades.

  • initiatorID: (Erforderlich) die ID des zu ändernden Initiators. (Ganze Zahl)

  • initiatorSecret: (Optional) Ein neuer CHAP-Schlüssel, der zur Authentifizierung des Initiators verwendet wird. (Zeichenfolge)

  • requireChap: (Optional) true, wenn CHAP für diesen Initiator erforderlich ist. (boolesch)

  • targetSecret: (Optional) Ein neuer CHAP-Schlüssel zur Authentifizierung des Ziels (bei Verwendung der gegenseitigen CHAP-Authentifizierung). (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 der Initiator hinzugefügt werden soll. Wenn der Initiator zuvor in einer anderen Volume-Zugriffsgruppe war, wird er aus der alten Volume-Zugriffsgruppe entfernt. Wenn dieser Schlüssel vorhanden ist, jedoch null, wird der Initiator aus seiner aktuellen Volume-Zugriffsgruppe entfernt, jedoch nicht in einer neuen Volume-Zugriffsgruppe platziert. (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 geänderten Initiatoren beschreiben

Initiator Array

Anforderungsbeispiel

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

{
  "id": 6683,
  "method": "ModifyInitiators",
  "params": {
    "initiators": [
      {
        "initiatorID": 2,
        "alias": "alias1",
        "volumeAccessGroupID": null
      },
      {
        "initiatorID": 3,
        "alias": "alias2",
        "volumeAccessGroupID": 1
      }
    ]
  }
}

Antwortbeispiel

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

{
  "id": 6683,
  "result": {
    "initiators": [
      {
        "alias": "alias1",
        "attributes": {},
        "initiatorID": 2,
        "initiatorName": "iqn.1993-08.org.debian:01:395543635",
        "volumeAccessGroups": []
      },
      {
        "alias": "alias2",
        "attributes": {},
        "initiatorID": 3,
        "initiatorName": "iqn.1993-08.org.debian:01:935573135",
        "volumeAccessGroups": [
          1
        ]
      }
    ]
  }
}

Neu seit Version

9,6

Weitere Informationen