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

更新

描述

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"
       }
       ]
       },
       "id": 1
       }

响应:

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

源码

ui/include/classes/api/services/CValueMap.php 中的 CValueMap::update()。