ModificyAccount
Sugerir cambios
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:
|
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. |
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