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.

CreateInitiators

Colaboradores
PDF

Puede usar CreateInitiators para crear varios IQN de iniciador nuevos o nombres de puerto WWPN y, opcionalmente, asignarles alias y atributos. Cuando se usa CreateInitiators para crear iniciadores nuevos, es posible añadirlos también a grupos de acceso de volúmenes.

Si la operación no puede crear uno de los iniciadores proporcionados en el parámetro, el método devuelve un error y no crea 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 nuevo. Objetos:

  • alias: (Opcional) Nombre descriptivo para asignar a este iniciador. (cadena)

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

  • chapUsername: (Opcional) El nombre de usuario CHAP único para este iniciador. Los valores predeterminados del nombre del iniciador (IQN) si no se especifican durante la creación y requiredChap son true. (cadena)

  • initiatorSecret: (Opcional) El secreto CHAP utilizado para autenticar el iniciador. Por defecto, es un secreto generado aleatoriamente si no se especifica durante la creación y requiredChap es true. (cadena)

  • name: (Necesario) El nombre del iniciador (IQN o WWPN) que se va a crear. (cadena)

  • requireChap: (Opcional) Verdadero si se requiere CHAP durante el inicio de sesión para este iniciador. (booleano)

  • targetSecret: (Opcional) El secreto CHAP utilizado para autenticar el destino (cuando se utiliza la autenticación CHAP mutua). Por defecto, es un secreto generado aleatoriamente si no se especifica durante la creación y requiredChap es true. (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 añadirá el iniciador recién creado. (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 creados.

iniciador cabina

Error

Este método puede devolver el siguiente error:

Nombre

Descripción

XInitiatorExists

Devuelto si el nombre del iniciador que ha elegido ya existe.

Ejemplo de solicitud

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

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

Ejemplo de respuesta

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

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

Nuevo desde la versión

9,6

Obtenga más información

ListInitiators