更新
描述
object maintenance.update(object/array maintenances)
此方法允许您更新现有的维护。
此方法仅适用于 Admin 和 Super admin 用户类型。调用该方法的权限可以在用户角色 设置中撤销。有关更多信息,请参见 User roles。
参数
(object/array) 要更新的维护属性。
必须为每个维护定义 maintenanceid 属性,其他所有属性均为可选。只有传入的属性会被更新,其他所有属性将保持不变。
除了标准维护属性之外,该方法还接受以下参数。
| 参数 | 类型 | 描述 |
|---|---|---|
| groups | object/array | 用于替换当前组的主机组。 主机组必须仅定义 groupid 属性。参数行为: - 如果未设置 hosts,则为必需 |
| hosts | object/array | 用于替换当前主机的主机。 主机必须仅定义 hostid 属性。参数行为: - 如果未设置 groups,则为必需 |
| timeperiods | object/array | 用于替换当前时间段的维护时间段。 |
| tags | object/array | 用于替换当前标签的问题标签。 参数行为: - 当维护对象的 maintenance_type 设置为“采集数据”时,支持该参数 |
返回值
(object)在maintenanceids属性中返回一个包含已被更新的维护模式的IDs的对象。
案例
指定不同的主机
将当前分配维护的主机替换为两台不同的主机。
请求:
{
"jsonrpc": "2.0",
"method": "maintenance.update",
"params": {
"maintenanceid": "3",
"hosts": [
{"hostid": "10085"},
{"hostid": "10084"}
]
},
"id": 1
}
响应:
{
"jsonrpc": "2.0",
"result": {
"maintenanceids": [
"3"
]
},
"id": 1
}
另请参阅
来源
CMaintenance::update() in ui/include/classes/api/services/CMaintenance.php.