object user.update(object/array users)
Ta metoda pozwala na aktualizację istniejących użytkowników.
Ta metoda jest dostępna dla użytkowników dowolnego typu. Uprawnienia do wywoływania metody można odebrać w ustawieniach roli użytkownika. Zobacz Role użytkownika aby uzyskać więcej informacji.
Siła hasła użytkownika jest walidowana zgodnie z zasadami zdefiniowanymi w polityce hasła dostępnej w API uwierzytelniania. Zobacz API uwierzytelniania aby uzyskać więcej informacji.
(object/array)
Właściwości użytkownika do zaktualizowania.
Właściwość userid
musi być zdefiniowana dla każdego użytkownika, wszystkie inne właściwości są opcjonalne. Tylko przekazane właściwości zostaną zaktualizowane, wszystkie inne pozostaną niezmienione.
Oprócz standardowych właściwości użytkownika, metoda akceptuje następujące parametry.
Parametr | Typ | Opis |
---|---|---|
passwd | string | Hasło użytkownika. Może być pustym ciągiem znaków, jeśli użytkownik należy do grup lub jest przenoszony tylko do grup, które mają dostęp LDAP. |
usrgrps | array | Grupy użytkowników, które zastąpią istniejące grupy użytkowników. Grupy użytkowników muszą mieć zdefiniowaną właściwość usrgrpid . |
medias | array | Media użytkownika, które zastąpią istniejące media. |
user_medias (przestarzałe) |
array | Ten parametr jest przestarzały, zamiast tego użyj medias .Media użytkownika, które zastąpią istniejące media. |
(obiekt)
Zwraca obiekt zawierający identyfikatory zaktualizowanych użytkowników we właściwości userids
.
Zmień nazwę użytkownika na John Doe.
Zapytanie:
{
"jsonrpc": "2.0",
"method": "user.update",
"params": {
"userid": "1",
"name": "John",
"surname": "Doe"
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}
Odpowiedź:
Zmień rolę użytkownika.
Zapytanie:
{
"jsonrpc": "2.0",
"method": "user.update",
"params": {
"userid": "12",
"roleid": "6"
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}
Odpowiedź:
CUser::update() w ui/include/classes/api/services/CUser.php.