更新

描述

object service.update(object/array services)

此方法允许更新已有的服务 ::: 请注意 此方法允许任何用户使用。可以在用户角色设置中撤销调用此方法的权限。更多信息请查看 用户角色 :::

参数

(object/array)需要更新的服务属性。 必须为每个服务定义serviceid属性，所有其他属性为可选项。只有通过的属性会被更新，所有其他属性将保持不变。 除standard service properties之外，该方法接受以下参数。 |参数|类型| 描述| |—|—|———| |children|array|子服务取代当前的子服务

子服务必须有唯一的serviceid属性。| |parents|array|父服务取代当前的父服务

父服务必须有唯一的serviceid属性。| |tags|array|服务标签以替换当前服务标签。| |problem_tags|array|问题标签以替换当前问题标签。| |status_rules|array|状态规则以替换当前状态规则。|

返回值

(对象) 返回一个serviceids属性包含了被更新服务ID的对象。

示例

设置服务的父服务

使ID为“3”的服务成为ID为“5”的服务的父服务。 请求:

  1. {
  2.            "jsonrpc": "2.0",
  3.            "method": "service.update",
  4.            "params": {
  5.                "serviceid": "5",
  6.                "parents": [
  7.                    {
  8.                        "serviceid": "3"
  9.                    }
  10.                ]
  11.            },
  12.            "id": 1
  13.        }

响应:

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

增加关机计划

给ID为“4”的服务增加每周一22:00到周二10:00的关机计划。 请求:

  1. {
  2.            "jsonrpc": "2.0",
  3.            "method": "service.update",
  4.            "params": {
  5.                "serviceid": "4",
  6.                "times": [
  7.                    {
  8.                        "type": "1",
  9.                        "ts_from": "165600",
  10.                        "ts_to": "201600"
  11.                    }
  12.                ]
  13.            },
  14.            "id": 1
  15.        }

响应:

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

来源

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