Go to main content
Guía de API de RESTful de Oracle® ZFS Storage Appliance (versión OS8.7.0)

Salir de la Vista de impresión

Actualización: Marzo de 2017
 
 

Creación de usuario

Para obtener más información acerca de los usuarios y los tipos de usuario, consulte Descripción de usuarios y roles de Guía de administración de Oracle ZFS Storage Appliance (versión OS8.7.0).

Este comando usa tres formas:

  • Crear usuario nuevo: permite crear un usuario nuevo.

  • Clonar usuario existente: permite clonar un nuevo usuario a partir de un usuario existente

  • Agregar un administrador: permite a un usuario definido en un directorio de empresa administrar el dispositivo.

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

Crear propiedades de usuario nuevo

Tabla 117  Crear propiedades de usuario nuevo
Tipo
Nombre de propiedad
Descripción
string
logname
Nombre de inicio de sesión del usuario nuevo (requerido)
number
uid
ID de usuario opcional
string
fullname
Nombre completo del usuario nuevo (requerido)
string
type
"Local", "De datos", "Sin inicio de sesión" (el valor por defecto es "Local")
string
initial_password
Contraseña inicial del usuario (solo para "Local" y "De datos")
boolean
require_annotation
Indicador opcional para requerir la anotación de la sesión (solo para "Local")

Clonar propiedades de usuario

Tabla 118  Clonar propiedades del usuario
Tipo
Nombre de propiedad
Descripción
string
usuario
Nombre de usuario de origen
number
uid
ID de usuario, no activado para usuarios de directorio
string
clonename
Nombre de inicio de sesión de clones nuevos
string
fullname
Nombre de usuario completo de clon nuevo (no válido para usuarios de directorio)
string
password
Contraseña de usuario de clon nuevo (no válida para usuarios de directorio o sin inicio de sesión)

Agregar propiedades de administrador

Tabla 119  Agregar propiedades de administrador
Tipo
Nombre de propiedad
Descripción
string
type
Usuarios de directorio
string
logname
Nombre de inicio de sesión de usuario de directorio
Ejemplo 1  Creación de un usuario local

Ejemplo de solicitud:

POST /api/user/v1/users HTTP/1.1
Host: zfssa.example.com:215
Authorization: Basic abcdefghijklmnop
Content-type: application/json

{
    "type": "local",
    "logname": "john",
    "initial_password": "DummyPassword",
    "fullname": "John Doe"
}

Resultado de ejemplo:

  
{
    "user":
    {
        "href": "/api/user/v1/users/john",
        "logname": "john",
        "type": "local",
        "uid": 2000000002,
        "fullname": "John Doe",
        "initial_password": "DummyPassword",
        "require_annotation": false,
        "roles": [
            "basic"
        ],
        "kiosk_mode": false,
        "kiosk_screen": "status/dashboard",
        "exceptions": [
        ],
        "preferences": {
            "href": "/api/user/v1/users/john/preferences",
            "locale": "C",
            "login_screen": "status/dashboard",
            "session_timeout": 15,
            "advanced_analytics": false,
            "keys": [
            ]
        }
    }
}
Ejemplo 2  Creación de un usuario de directorio

Ejemplo de solicitud:

POST /api/user/v1/users
{
    "type": "directory",    
    "logname": "john" 
}

Resultado de ejemplo:

 
{
    "user": 
    {
        "href": "/api/user/v1/users/john",
        "logname": "john",
        "type": "directory",
        "uid": 26718,
        "fullname": "John Doe",
        "require_annotation": false,
        "roles": [
            "basic"
        ],
        "kiosk_mode": false,
        "kiosk_screen": "status/dashboard",
        "exceptions": [
        ],
        "preferences": {
            "href": "/api/user/v1/users/john/preferences",
            "locale": "C",
            "login_screen": "status/dashboard",
            "session_timeout": 15,
            "advanced_analytics": false,
            "keys": [
            ]
        }
    }
}
Ejemplo 3  Creación de un usuario solo para datos

Ejemplo de solicitud:

POST /api/user/v1/users
{
    "type": "data",
    "logname": "john",
    "initial_password": "password",
    "fullname": "John Doe",
    "uid": 5000000
}

Resultado de ejemplo:

{
    "user": 
    {
        "href": "/api/user/v1/users/data",
        "logname": "john",
        "type": "data",
        "uid": 5000000,
        "fullname": "John Doe",
        "initial_password": "DummyPassword"
    }
}
Ejemplo 4  Creación de un usuario sin inicio de sesión

Ejemplo de solicitud:

 
POST /api/user/v1/users
{
    "type": "nologin",
    "logname": "john",
    "fullname": "John Doe",
    "uid": 5000001
}

Resultado de ejemplo:

{
    "user": 
    {
        "href": "/api/user/v1/users/john",
        "logname": "john",
        "type": "nologin",
        "uid": 5000001,
        "fullname": "John Doe"
    }
}