更新
描述
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:
改变聚合图形属主
仅仅适用于管理员和超级管理员
Request:
{ "jsonrpc": "2.0", "method": "screen.update", "params": { "screenid": "83", "userid": "1" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 2 }Response:
See also
- Screen item
- screenitem.create
- screenitem.update
- screenitem.updatebyposition
- Screen user
- Screen user group
源
CScreen::update() in frontends/php/include/classes/api/services/CScreen.php.