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 :
|
Les propriétés liées au clonage d'un utilisateur existant sont les suivantes :
|
Les propriétés liées à l'ajout d'un administrateur sont les suivantes :
|
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": {}
}
}
}