service.update

描述

object service.update(object/array services)

此方法允许更新现有服务。

该方法可供任何类型的用户使用。调用该方法的权限可在用户角色设置中撤销。更多信息请参阅User roles

参数

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

每个服务必须定义serviceid属性,其他属性均为可选。仅传递的属性会被更新,其余属性将保持不变。

服务外,该方法还接受以下参数。

参数 数据类型 描述
children array 用于替换当前服务子项的子服务。

子项必须定义serviceid属性。
parents array 用于替换当前服务父项的父服务。

父项必须定义serviceid属性。
tags array 用于替换当前服务标签的服务标签
problem_tags array 用于替换当前问题标签的问题标签
status_rules array 用于替换当前状态规则的状态规则

返回值

(object) 返回一个包含更新服务ID的object,这些ID存储在serviceids属性下。

示例

设置服务的父级

将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 文件中。