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)
返回一个包含更新服务ID的object,这些ID位于serviceids
属性下。
将ID为"3"的服务设置为ID为"5"的服务的父级。
请求:
{
"jsonrpc": "2.0",
"method": "service.update",
"params": {
"serviceid": "5",
"parents": [
{
"serviceid": "3"
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"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
}
响应:
CService::update() 位于 ui/include/classes/api/services/CService.php 文件中。