Go to main content
Guide RESTful API des systèmes Oracle® ZFS Storage Appliance, version OS8.6.x

Quitter la vue de l'impression

Mis à jour : Septembre 2016
 
 

Création d'utilisateur

Pour en savoir plus sur les utilisateurs et les types d'utilisateur, reportez-vous à la section Présentation des utilisateurs et des rôles du manuel Guide d’administration des systèmes Oracle ZFS Storage Appliance, version OS8.6.x.

Cette commande utilise trois formulaires :

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

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

  • Ajout d'un administrateur : permet à un utilisateur défini dans un annuaire d'entreprise de gérer l'appareil.

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

Propriétés de création d'un nouvel utilisateur

Table 110  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)
number
uid
ID utilisateur facultatif
string
fullname
Nom complet du nouvel utilisateur (obligatoire)
string
type
"Local", "Données seules", "Sans connexion" ("Local" étant la valeur par défaut)
string
initial_password
Mot de passe initial de l'utilisateur ("Local" et "Données seules" uniquement)
boolean
require_annotation
Indicateur facultatif d'annotation de session requise ("Local" uniquement)

Propriétés de clonage d'un utilisateur

Table 111  Propriétés de clonage d'un utilisateur
Type
Nom de la propriété
Description
string
user
Nom de l'utilisateur source
number
uid
ID utilisateur, non activé pour les utilisateurs d'annuaire
string
clonename
Nom de connexion du nouveau clone
string
fullname
Nom complet du nouvel utilisateur cloné (pas pour les utilisateurs d'annuaire)
string
mot de passe
Mot de passe du nouvel utilisateur cloné (pas pour les utilisateurs d'annuaire ou sans connexion)

Ajout de propriétés administrateur

Table 112  Ajouter des propriétés administrateur
Type
Nom de la propriété
Description
string
type
Utilisateurs d'annuaire
string
logname
Nom de connexion de l'utilisateur d'annuaire
Exemple 1  Création d'un utilisateur local

Exemple de demande :

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

Exemple de résultat :

  
{
    "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": [
            ]
        }
    }
}
Exemple 2  Création d'un utilisateur d'annuaire

Exemple de demande :

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

Exemple de résultat :

 
{
    "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": [
            ]
        }
    }
}
Exemple 3  Création d'un utilisateur de données

Exemple de demande :

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

Exemple de résultat :

{
    "user": 
    {
        "href": "/api/user/v1/users/data",
        "logname": "john",
        "type": "data",
        "uid": 5000000,
        "fullname": "John Doe",
        "initial_password": "DummyPassword"
    }
}
Exemple 4  Création d'un utilisateur sans connexion

Exemple de demande :

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

Exemple de résultat :

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