Documentation
Table of Contents
user.create
Description
object user.create(object/array users)
Cette méthode permet de créer de nouveaux utilisateurs.
Cette méthode est seulement disponible pour les utilisateurs du type Super admin. Les autorisations d'appeler la méthode peuvent être révoquées dans les paramètres de rôle d'utilisateur. Voir Rôles utilisateur pour plus d'informations.
La force du mot de passe de l'utilisateur est validée selon les règles de politique de mot de passe définies par l'API d'authentification. Voir l'API d'authentification pour plus d'informations.
Paramètres
(object/array) Utilisateurs à créer.
En plus des propriétés utilisateur standard, la méthode accepte les paramètres suivants.
| Paramètre | Type | Description |
|---|---|---|
| passwd (obligatoire) |
string | Mot de passe de l'utilisateur. Peut être omis si l'utilisateur est ajouté uniquement aux groupes disposant d'un accès LDAP. |
| usrgrps (obligatoire) |
array | Groupes d'utilisateurs auxquels ajoutés l'utilisateur. Les groupes d'utilisateurs doivent avoir la propriété usrgrpid définie. |
| medias | array | Média utilisateur à créer. |
| user_medias (obsolète) |
array | Ce paramètre est obsolète, veuillez utiliser medias à la place.Média utilisateur à créer. |
Valeurs retournées
(object) Renvoie un objet contenant les ID des utilisateurs créés sous la propriété userids. L'ordre des ID renvoyés correspond à l'ordre des utilisateurs passés.
Exemples
Création d'un utilisateur
Créez un nouvel utilisateur, ajoutez-le à un groupe d'utilisateurs et créez un nouveau média pour lui.
Requête :
{
"jsonrpc": "2.0",
"method": "user.create",
"params": {
"username": "John",
"passwd": "Doe123",
"roleid": "5",
"usrgrps": [
{
"usrgrpid": "7"
}
],
"medias": [
{
"mediatypeid": "1",
"sendto": [
"[email protected]"
],
"active": 0,
"severity": 63,
"period": "1-7,00:00-24:00"
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Réponse :
Voir également
Source
CUser::create() dans ui/include/classes/api/services/CUser.php.