Skip to main content
Element Software
12.5
Hay disponible una nueva versión de este producto.
Se proporciona el idioma español mediante traducción automática para su comodidad. En caso de alguna inconsistencia, el inglés precede al español.

ModificyInitiators

Colaboradores
PDF

Puede usar el ModifyInitiators método para cambiar los atributos de uno o más iniciadores existentes.

No puede cambiar el nombre de un iniciador existente. Si necesita cambiar el nombre de un iniciador, primero elimínelo con el DeleteInitiators método y cree uno nuevo con el CreateInitiators método.

Si ModifyInitiators no cambia uno de los iniciadores proporcionados en el parámetro, el método devuelve un error y no modifica ningún iniciador (no es posible completar parcialmente).

Parámetro

Este método tiene el siguiente parámetro de entrada:

Nombre

Descripción

Tipo

Valor predeterminado

Obligatorio

iniciadores

Una lista de objetos que contienen características de cada iniciador que se va a modificar. Objetos posibles:

  • alias: (Opcional) Un nuevo nombre descriptivo para asignar al iniciador. (cadena)

  • attributes: (Opcional) Un nuevo conjunto de atributos JSON para asignar al iniciador. (Objeto JSON)

  • chapUsername: (Opcional) Un nuevo nombre de usuario CHAP único para este iniciador. (cadena)

  • forceDuringUpgrade: Completa la modificación del iniciador durante una actualización.

  • initiatorID: (Requerido) El ID del iniciador que se va a modificar. (entero)

  • initiatorSecret: (Opcional) Un nuevo secreto CHAP utilizado para autenticar el iniciador. (cadena)

  • requireChap: (Opcional) Verdadero si se requiere CHAP para este iniciador. (booleano)

  • targetSecret: (Opcional) Un nuevo secreto CHAP utilizado para autenticar el destino (cuando se utiliza la autenticación CHAP mutua). (cadena)

  • virtualNetworkIDs: (Opcional) Lista de identificadores de red virtual asociados a este iniciador. Si define una o más redes virtuales, este iniciador solo puede iniciar sesión en esas redes virtuales. Si no define ninguna red virtual, este iniciador puede iniciar sesión en todas las redes.

  • volumeAccessGroupID: (Opcional) El ID del grupo de acceso de volúmenes al que se debe añadir el iniciador. Si el iniciador se encontraba previamente en un grupo de acceso de volúmenes diferente, se elimina del grupo de acceso de volúmenes antiguo. Si esta clave está presente pero es nula, el iniciador se elimina de su grupo de acceso de volúmenes actual, pero no se coloca en ningún grupo de acceso de volúmenes nuevo. (entero)

Cabina de objetos JSON

Ninguno

Sí

Valor de retorno

Este método tiene el siguiente valor devuelto:

Nombre

Descripción

Tipo

iniciadores

Lista de objetos que describen los iniciadores recién modificados.

iniciador cabina

Ejemplo de solicitud

Las solicitudes de este método son similares al ejemplo siguiente:

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

Ejemplo de respuesta

Este método devuelve una respuesta similar al siguiente ejemplo:

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

Nuevo desde la versión

9,6

Obtenga más información