这是原厂英文文档的翻译页面. 欢迎帮助我们 完善文档.

Sidebar

Zabbix Summit 2022
Register for Zabbix Summit 2022

获取

说明

integer/array user.get(object parameters)

此方法允许根据给定的参数获取用户。

参数

(object) 定义所需输出的参数。

该方法支持以下参数。

属性 类 说明
mediaids string/array 只返回用户给定媒体。
mediatypeids string/array 只返回用户给定媒体类型。
userids string/array 只返回用户给定ID。
usrgrpids string/array 只返回用户给定用户组ID。
getAccess flag 添加关于用户权限附加信息。

为每个用户添加以下属性:
gui_access - (integer) 用户的前端认证方法。 参考 gui_access 的属性 关于用户组对象 列出可能的值。
debug_mode - (integer) 表明是否为用户启用了调试功能。 可能的值: 0 - 禁用调试, 1 - 开启调试。
users_status - (integer) 表示用户是否禁用。 可能的值: 0 - 用户可用, 1 - 用户禁用。
selectMedias query medias 属性返回用户使用的媒体。
selectMediatypes query mediatypes 属性返回用户使用的媒体类型。
selectUsrgrps query usrgrps 属性返回用户所属的组
sortfield string/array 根据给定的属性对结果进行排序。

可能的值 : userid and alias.
countOutput boolean 这些参数对于所有的get方法是常见的,在 参考说明中有详细描述.
editable boolean
excludeSearch boolean
filter object
limit integer
output query
preservekeys boolean
search object
searchByAny boolean
searchWildcardsEnabled boolean
sortorder string/array
startSearch boolean

返回值

(integer/array)返回:

  • 一个对象数组;
  • 检索对象的计数, 如果 countOutput 参数被使用。

示例

获取用户

获取所有已配置的用户。

Request:

{
           "jsonrpc": "2.0",
           "method": "user.get",
           "params": {
               "output": "extend"
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Response:

{
           "jsonrpc": "2.0",
           "result": [
               {
                   "userid": "1",
                   "alias": "Admin",
                   "name": "Zabbix",
                   "surname": "Administrator",
                   "url": "",
                   "autologin": "1",
                   "autologout": "0s",
                   "lang": "ru_RU",
                   "refresh": "0s",
                   "type": "3",
                   "theme": "default",
                   "attempt_failed": "0",
                   "attempt_ip": "",
                   "attempt_clock": "0",
                   "rows_per_page": "50"
               },
               {
                   "userid": "2",
                   "alias": "guest",
                   "name": "Default2",
                   "surname": "User",
                   "url": "",
                   "autologin": "0",
                   "autologout": "15m",
                   "lang": "en_GB",
                   "refresh": "30s",
                   "type": "1",
                   "theme": "default",
                   "attempt_failed": "0",
                   "attempt_ip": "",
                   "attempt_clock": "0",
                   "rows_per_page": "50"
               }
           ],
           "id": 1
       }

参考

来源

CUser::get() in frontends/php/include/classes/api/services/CUser.php.