更新

说明

object valuemap.update(object/array **valuemaps**)

该方法允许更新现有的值映射。

参数

(object/array) 要更新的值映射特性

必须为每个值映射定义valuemapid属性,所有其他属性都是可选的。 只有通过的属性将被更新,所有其他属性将保持不变。

返回值

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

示例

更改值映射名称

将值映射名称更改为“设备状态”

Request:

  1. {
  2. "jsonrpc": "2.0",
  3. "method": "valuemap.update",
  4. "params": {
  5. "valuemapid": "2",
  6. "name": "Device status"
  7. },
  8. "auth": "57562fd409b3b3b9a4d916d45207bbcb",
  9. "id": 1
  10. }

Response:

  1. {
  2. "jsonrpc": "2.0",
  3. "result": {
  4. "valuemapids": [
  5. "2"
  6. ]
  7. },
  8. "id": 1
  9. }

更改一个值映射的映射

Request:

  1. {
  2. "jsonrpc": "2.0",
  3. "method": "valuemap.update",
  4. "params": {
  5. "valuemapid": "2",
  6. "mappings": [
  7. {
  8. "value": "0",
  9. "newvalue": "Online"
  10. },
  11. {
  12. "value": "1",
  13. "newvalue": "Offline"
  14. }
  15. ]
  16. },
  17. "auth": "57562fd409b3b3b9a4d916d45207bbcb",
  18. "id": 1
  19. }

Response:

  1. {
  2. "jsonrpc": "2.0",
  3. "result": {
  4. "valuemapids": [
  5. "2"
  6. ]
  7. },
  8. "id": 1
  9. }

来源

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