Crear usuario

Este comando utiliza tres formas:

• Crear un nuevo usuario local: crea un nuevo usuario local.

• Clonar un usuario existente: clona un nuevo usuario a partir de un usuario existente.

• Agregar un administrador: requiere que se configure la propiedad netuser con el nombre del usuario de red.

En los tres casos, se envía a los usuarios una solicitud POST con propiedades con formato de JSON en el cuerpo.

Crear un nuevo usuario local tiene las siguientes propiedades:

Tabla 14-5  Crear propiedades de usuario nuevo

Tipo Nombre de propiedad Descripción string logname Nombre de inicio de sesión del usuario nuevo (requerido) string fullname Nombre completo del usuario nuevo (requerido) string initial_password Contraseña inicial del usuario (requerida) boolean require_annotation Indicador opcional para requerir la anotación de la sesión.

Clonar un usuario existente tiene las propiedades requeridas siguientes:

Tabla 14-6  Clonar propiedades del usuario

Tipo Nombre de propiedad Descripción string usuario Nombre de usuario de origen string clonename Nombre de inicio de sesión de clones nuevos string fullname Nombre de usuario completo de clon nuevo (solamente local) boolean password Contraseña del usuario clon nuevo (solamente local)

Agregar un administrador tiene las siguientes propiedades:

Tabla 14-7  Propiedades de usuario de red

Tipo Nombre de propiedad Descripción string netuser Nombre de inicio de sesión de usuario de red

Ejemplo de solicitud (para crear un usuario local):

POST /api/user/v1/users HTTP/1.1
Authorization: Basic abcefgMWE=
Host: zfssa.example.com:215
Accept: application/json
Content-Type: application/json
Content-Length: 71

{"logname":"joe", "fullname":"Joe Admin", "initial_password":"letmein"}

Resultado de ejemplo:

HTTP/1.1 201 Created
X-Zfssa-Appliance-Api: 1.0
Content-Type: application/json
Content-Length: 386
Location: /api/user/v1/users/joe

{
    "user": {
        "href": "/api/user/v1/users",
        "logname": "joe",
        "fullname": "Joe Admin",
        "initial_password": "DummyPassword",
        "require_annotation": false,
        "kiosk_mode": false,
        "kiosk_screen": "status/dashboard",
        "roles": ["basic"],
        "exceptions": {},
        "preferences": {
            "locale": "C",
            "login_screen": "status/dashboard",
            "session_timeout": 15,
            "advanced_analytics": false,
            "keys": {}
        }
    }
}