service.update
描述
object service.update(object/array services)
此方法用于 update 现有服务。
此方法可供任何类型的用户使用。调用该方法的权限 可以在用户角色设置中撤销。更多信息请参见 User roles。
参数
(object/array) 要更新的 service 属性。
必须为每个 service 定义 serviceid 属性，其他所有属性均为可选。只有传入的属性会被更新，其余属性将保持不变。
除了标准 service 属性之外，该方法还接受以下参数。
| Parameter | Type | Description |
|---|---|---|
| children | array | 要替换当前子 service 的子级 services。 子级 service 只能定义 serviceid 属性。 |
| parents | array | 要替换当前父级 service 的父级 services。 父级 service 只能定义 serviceid 属性。 |
| tags | array | 用于替换当前 service 标签的 Service tags。 |
| problem_tags | array | 用于替换当前 problem 标签的 Problem tags。 |
| status_rules | array | 用于替换当前状态规则的 Status rules。 |
返回值
(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 文件中。