user.create
Beschreibung
object user.create(object/array users)
Diese Methode ermöglicht es Ihnen, neue Benutzer zu erstellen.
Diese Methode ist nur für den Benutzertyp Super admin verfügbar. Die Berechtigung zum Aufrufen der Methode kann in den Benutzerrollen-Einstellungen widerrufen werden. Weitere Informationen finden Sie unter Benutzerrollen.
Die Stärke des Benutzerpassworts wird gemäß den von der Authentication API definierten Passwort-Richtlinienregeln validiert. Weitere Informationen finden Sie unter Authentication API.
Parameter
(object/array) Zu erstellende Benutzer.
Zusätzlich zu den Standard-Benutzereigenschaften akzeptiert die Methode die folgenden Parameter.
| Parameter | Typ | Beschreibung |
|---|---|---|
| usrgrps | array | Benutzergruppen, zu denen der Benutzer hinzugefügt werden soll. Für die Benutzergruppen darf nur die Eigenschaft usrgrpid definiert sein. |
| medias | array | Benutzermedien, die erstellt werden sollen. |
Rückgabewerte
(object) Gibt ein Objekt zurück, das die IDs der erstellten Benutzer
unter der Eigenschaft userids enthält. Die Reihenfolge der
zurückgegebenen IDs entspricht der Reihenfolge der übergebenen Benutzer.
Beispiele
Einen Benutzer erstellen
Erstellen Sie einen neuen Benutzer, fügen Sie ihn einer Benutzergruppe hinzu und erstellen Sie ein neues Medium für ihn.
{
"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"
}
]
},
"id": 1
}Antwort:
{
"jsonrpc": "2.0",
"result": {
"userids": [
"12"
]
},
"id": 1
}Siehe auch
Quelle
CUser::create() in ui/include/classes/api/services/CUser.php.