user.update

Beschreibung

object user.update(object/array users)

Diese Methode ermöglicht es Ihnen, vorhandene Benutzer zu aktualisieren.

Diese Methode ist für Benutzer aller Typen verfügbar. Die Berechtigung zum Aufrufen der Methode kann in den Einstellungen der Benutzerrolle widerrufen werden. Weitere Informationen finden Sie unter Benutzerrollen.

Die Stärke des Benutzerkennworts wird gemäß den Kennwortrichtlinien überprüft, die von der Authentication API definiert sind. Weitere Informationen finden Sie unter Authentication API.

Parameter

(object/array) Zu aktualisierende Benutzereigenschaften.

Die Eigenschaft userid muss für jeden Benutzer definiert sein, alle anderen Eigenschaften sind optional. Nur die übergebenen Eigenschaften werden aktualisiert, alle anderen bleiben unverändert.

Zusätzlich zu den Standard-Benutzereigenschaften akzeptiert die Methode die folgenden Parameter.

Parameter Type Beschreibung
current_passwd string Aktuelles Passwort des Benutzers.

Der Wert dieses Parameters kann eine leere Zeichenfolge sein, wenn der Benutzer mit einem Benutzerverzeichnis verknüpft ist.

Parameter behavior:
- write-only
- required if passwd of User object is set and user changes own user password
usrgrps array Benutzergruppen zum Ersetzen bestehender Benutzergruppen.

Für die Benutzergruppen darf nur die Eigenschaft usrgrpid definiert sein.
medias array Benutzermedien zum Ersetzen vorhandener, nicht bereitgestellter Medien. Bereitgestellte Medien können beim Aktualisieren von Medien weggelassen werden.

Rückgabewerte

(object) Gibt ein Objekt zurück, das die IDs der aktualisierten Benutzer unter der Eigenschaft userids enthält.

Beispiele

Umbenennen eines Benutzers

Benennen Sie einen Benutzer in John Doe um.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "user.update",
    "params": {
        "userid": "1",
        "name": "John",
        "surname": "Doe"
    },
    "id": 1
}

Antwort:

{
    "jsonrpc": "2.0",
    "result": {
        "userids": [
            "1"
        ]
    },
    "id": 1
}

Ändern der Benutzerrolle

Ändern Sie die Rolle eines Benutzers.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "user.update",
    "params": {
        "userid": "12",
        "roleid": "6"
    },
    "id": 1
}

Antwort:

{
    "jsonrpc": "2.0",
    "result": {
        "userids": [
            "12"
        ]
    },
    "id": 1
}

Siehe auch

Quelle

CUser::update() in ui/include/classes/api/services/CUser.php.