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
}
响应:
为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 文件中。