Skip to main content
Element Software
12.5 and 12.7
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.

ModificyAccount

Colaboradores
PDF

Puede utilizar el ModifyAccount método para modificar una cuenta existente.

Cuando se bloquea una cuenta, las conexiones existentes de esa cuenta se finalizan inmediatamente. Cuando se cambia la configuración de CHAP de una cuenta, las conexiones existentes permanecen activas y la nueva configuración de CHAP se utiliza en conexiones o reconexiones posteriores. Para borrar los atributos de una cuenta, especifique {} para el parámetro Attributes.

Parámetros

Este método tiene los siguientes parámetros de entrada:

Nombre Descripción Tipo Valor predeterminado Obligatorio

ID de cuenta

ID de cuenta de la cuenta que se va a modificar.

entero

Ninguno

Sí

atributos

La lista de pares nombre-valor en el formato de objetos JSON.

Objeto JSON

Ninguno

No

EnableChap

Especifica si un iniciador puede utilizar las credenciales de la cuenta CHAP para acceder a volúmenes.

booleano

Ninguno

No

InitiatorSecret

El secreto CHAP que se utiliza para el iniciador. Este secreto debe tener entre 12-16 y 16 caracteres, y ser impenetrable. El secreto CHAP del iniciador debe ser único y no puede ser igual al secreto CHAP objetivo.

cadena

Ninguno

No

estado

Estado de la cuenta. Los posibles valores son los siguientes:

  • Active: La cuenta está activa y se permiten las conexiones.

  • Locked: La cuenta está bloqueada y las conexiones se rechazan.

cadena

Ninguno

No

TargetSecret

El secreto CHAP que se utiliza para el objetivo (autenticación CHAP mutua). Este secreto debe tener entre 12-16 y 16 caracteres, y ser impenetrable. El secreto CHAP objetivo debe ser único y no puede ser igual al secreto CHAP del iniciador.

cadena

Ninguno

No

nombre de usuario

Se utiliza para cambiar el nombre de usuario asociado a la cuenta. (Debe tener entre 1 y 64 caracteres de longitud).

cadena

Ninguno

No

Valor de retorno

Este método tiene el siguiente valor devuelto:

Nombre

Descripción

Tipo

cuenta

Objeto que contiene información acerca de la cuenta modificada.

cuenta

Ejemplo de solicitud

Las solicitudes de este método son similares al ejemplo siguiente. En este ejemplo, los atributos se borran especificando {} para ellos:

{
   "method": "ModifyAccount",
   "params": {
     "accountID"  : 25,
     "status"   : "locked",
     "attributes" : {}
   },
   "id" : 1
}

Ejemplo de respuesta

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

{
    "account": {
        "storageContainerID": "abcdef01-1234-5678-90ab-cdef01234567",
        "username": "user1",
        "accountID": 1,
        "volumes": [
        ],
        "enableChap": true,
        "initiatorSecret": "txz123456q890",
        "attributes": {
        },
        "status": active",
        "targetSecret": "rxe123b567890"
    }
}

Nuevo desde la versión

9.6