valuemap.update

描述

object valuemap.update(object/array valuemaps)

此方法用于 update 现有的值映射。

此方法仅适用于 超级管理员(Super admin) 用户类型。 调用该方法的权限可以在用户角色设置中撤销。更多信息请参见 User roles

参数

(object/array) 值映射 将被更新。

每个值映射都必须定义 valuemapid 属性,所有其他属性均为可选。仅更新传递的属性,其余属性将保持不变。

返回值

(object) 返回一个 object,其中包含更新后的值映射的 ID,这些 ID 位于 valuemapids 属性下。

示例

修改值映射名称

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

执行请求:

{
    "jsonrpc": "2.0",
    "method": "valuemap.update",
    "params": {
        "valuemapid": "2",
        "name": "Device status"
    },
    "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
}

Response:

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

来源

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