更新

描述

object valuemap.update(object/array valuemaps)

此方法允许更新已存在的值映射。

此方法只有Super admin(超级管理员) 用户可用。可以在用户角色设置中撤销调用该方法的权限。更多信息请查看 用户角色

参数

(object/array) Value map properties 更新。

每个值映射必须要定义valuemapid属性,其他属性都是可选的。只会更新传递的属性,其他的属性保持不变。

返回值

(object) 返回一个对象,包含被更新的值映射的ID,ID在valuemapids属性下。

示例

更新值映射名称

将值映射名称更新为“Device status”。

请求:

{
           "jsonrpc": "2.0",
           "method": "valuemap.update",
           "params": {
               "valuemapid": "2",
               "name": "Device status"
           },
           "auth": "57562fd409b3b3b9a4d916d45207bbcb",
           "id": 1
       }

响应:

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

更新一个值映射的映射关系。

请求:

{
           "jsonrpc": "2.0",
           "method": "valuemap.update",
           "params": {
               "valuemapid": "2",
               "mappings": [
                   {
                       "type": "0",
                       "value": "0",
                       "newvalue": "Online"
                   },
                   {
                       "type": "0",
                       "value": "1",
                       "newvalue": "Offline"
                   }
               ]
           },
           "auth": "57562fd409b3b3b9a4d916d45207bbcb",
           "id": 1
       }

响应:

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

来源

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