service.update

描述

object service.update(object/array services)

此方法用于 update 现有服务。

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

参数

(object/array) 服务属性将被更新。

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

除了服务外，该方法还接受以下参数。

参数	数据类型	描述
children	array	子级服务，用于替换当前的子服务。子服务必须仅定义 `serviceid` 属性。
parents	array	父级服务，用于替换当前的父服务。父服务必须仅定义 `serviceid` 属性。
tags	array	服务标签，用于替换当前的服务标签。
problem_tags	array	问题标签，用于替换当前的问题标签。
status_rules	array	状态规则，用于替换当前的状态规则。

返回值

(object) 返回一个 object，其中包含在 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() 方法位于 ui/include/classes/api/services/CService.php 文件中。

Documentation

service.update

描述

参数

返回值

示例

设置服务的父级

添加计划停机时间

来源