更新

描述

object screen.update(object/array screens)

此方法允许更新已存在的聚合图形

参数

(object/array) 聚合图形参数将被更新

每个聚合图形必须定义screenid参数，其他参数是可以选择的。仅传递的参数会被更新，其他的的参数将保持不变。

此外standard screen properties,此方法接受以下参数

Parameter	Type	Description
screenitems	array	聚合图形项替换已存在的聚合图行项聚合图形项通过坐标更新，所以每个聚合图形项必须拥定义`x` and `y`属性
users	array	聚合图形用户共享替换已存在的元素
userGroups	array	聚合图形用户组共享替换已存在的元素

返回值

(object) 返回一个对象，该对象包含screenids属性下更新聚合图形的id。

示例如下

重命名一个聚合图形

重命名一个聚合图形为"CPU Graphs".

Request:

{
           "jsonrpc": "2.0",
           "method": "screen.update",
           "params": {
               "screenid": "26",
               "name": "CPU Graphs"
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Response:

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

改变聚合图形属主

仅仅适用于管理员和超级管理员

Request:

{
           "jsonrpc": "2.0",
           "method": "screen.update",
           "params": {
               "screenid": "83",
               "userid": "1"
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 2
       }

Response:

{
           "jsonrpc": "2.0",
           "result": {
               "screenids": [
                   "83"
               ]
           },
           "id": 2
       }

源

CScreen::update() in frontends/php/include/classes/api/services/CScreen.php.

Documentation

更新

描述

参数

返回值

示例如下

重命名一个聚合图形

改变聚合图形属主

See also

源