service.update

描述

object service.update(object/array services)

此方法允许更新已有的服务。

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

参数

(对象/数组) 要更新的服务属性。

每个服务必须定义serviceid属性，其他所有的属性都是可选。只有被传入的属性会被更新，其他将保持不变。

除了标准服务属性，此方法允许以下参数。

参数	类型	描述
children	array	取代当前子服务的子服务。子服务必须定义`serviceid`属性。
parents	array	取代当前父服务的父服务。父服务必须定义`serviceid`属性。
tags	array	取代当前服务标记的服务标签。
problem_tags	array	取代当前问题标记的问题标签。
status_rules	array	取代当前状态规则的状态规则。

返回值

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

示例

设置服务的父服务

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

请求：

{
           "jsonrpc": "2.0",
           "method": "service.update",
           "params": {
               "serviceid": "5",
               "parents": [
                   {
                       "serviceid": "3"
                   }
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

响应：

{
           "jsonrpc": "2.0",
           "result": {
               "serviceids": [
                   "5"
               ]
           },
           "id": 1
       }

增加关机计划

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

请求：

{
           "jsonrpc": "2.0",
           "method": "service.update",
           "params": {
               "serviceid": "4",
               "times": [
                   {
                       "type": "1",
                       "ts_from": "165600",
                       "ts_to": "201600"
                   }
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

响应：

{
           "jsonrpc": "2.0",
           "result": {
               "serviceids": [
                   "4"
               ]
           },
           "id": 1
       }

来源

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

Documentation

service.update

描述

参数

返回值

示例

设置服务的父服务

增加关机计划

来源