service.update

描述

object service.update(object/array services)

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

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

Parameters 参数

(object/array) service properties to be updated. (object/array)需要更新的服务属性。 The serviceid property must be defined for each service, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. 必须为每个服务定义serviceid属性，所有其他属性为可选项。只有通过的属性会被更新，所有其他属性将保持不变。 Additionally to the standard service properties, the method accepts the following parameters. 除standard service properties之外，该方法接受以下参数。

Parameter 参数 Tpe 类型 Desription 说明
dependenciesarray 数组 Srvice dependencies to replace the current service dependencies. 用来替换当前内容的服务依赖关系。

Each service dependency has the following parameters: 每个服务依赖项具有以下参数：
- dependsOnServiceid - (string 字符串) ID of an service the service depends on, that is, the child service. 依赖服务的服务，即子服务的ID。
- soft - (integer 整数型) type of service dependency; 服务依赖类型；refer to the service dependency object page for more information on dependency types. 有关依赖关系类型的更多信息，请参阅service dependency object page。
parentidstring 字符串 IDof a hard-linked parent service. 硬链接的父服务ID。
timesarray 数组 Srvice times to replace the current service times. 用来替换当前内容的服务时间。

返回值

(对象) 返回一个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.            "auth": "038e1d7b1735c6a5436ee9eae095879e",
  13.            "id": 1
  14.        }

响应：

  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.            "auth": "038e1d7b1735c6a5436ee9eae095879e",
  15.            "id": 1
  16.        }

响应：

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

来源

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