更新

描述

object service.update(object/array services)

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

参数

(object/array) 要更新的服务属性。

必须为每个服务定义 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"
            }
        ]
    },
    "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"
            }
        ]
    },
    "id": 1
}

响应:

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

来源

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