更新

描述

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.