Create User

Cette commande utilise trois formulaires :

• Création d'un nouvel utilisateur local : crée un nouvel utilisateur local

• Clonage d'un utilisateur existant : clone un utilisateur existant pour créer un nouvel utilisateur

• Ajout d'un administrateur : requiert la définition de la propriété netuser avec le nom de l'utilisateur réseau

Dans les trois cas, une demande POST est envoyée aux utilisateurs, contenant dans le corps les propriétés au format JSON.

Les propriétés liées à la création d'un nouvel utilisateur local sont les suivantes :

Table 14-5  Propriétés de création d'un nouvel utilisateur

Type Nom de la propriété Description string logname Nom de connexion du nouvel utilisateur (obligatoire) string fullname Nom complet du nouvel utilisateur (obligatoire) string initial_password Mot de passe initial de l'utilisateur (obligatoire) boolean require_annotation Indicateur facultatif d'annotation de session requise

Les propriétés liées au clonage d'un utilisateur existant sont les suivantes :

Table 14-6  Propriétés de clonage d'un utilisateur

Type Nom de la propriété Description string user Nom de l'utilisateur source string clonename Nom de connexion des nouveaux clones string fullname Nom complet du nouvel utilisateur cloné (local uniquement) boolean mot de passe Mot de passe du nouvel utilisateur cloné (local uniquement)

Les propriétés liées à l'ajout d'un administrateur sont les suivantes :

Table 14-7  Propriétés de l'utilisateur réseau

Type Nom de la propriété Description string netuser Nom de connexion de l'utilisateur réseau

Exemple de demande (de création d'un utilisateur 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"}

Exemple de résultat :

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