更新
描述
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.