更新
描述
object maintenance.update(object/array maintenances)
此方法允许您更新现有的维护。
此方法仅适用于 Admin 和 Super admin 用户类型。调用该方法的权限可以在用户角色 设置中撤销。有关更多信息，请参见 User roles。
参数
(object/array) 要更新的维护属性。
必须为每个维护定义 maintenanceid 属性，其他所有属性均为可选属性。仅更新传递的属性，其他属性保持不变。
除标准维护属性外，该方法还接受以下参数。
| 参数 | 类型 | 描述 |
|---|---|---|
| groups | object/array | 用于替换当前主机组的主机组。 主机组只能定义 groupid 属性。参数行为： - 如果未设置 hosts，则为必需 |
| hosts | object/array | 用于替换当前主机的主机。 主机只能定义 hostid 属性。参数行为： - 如果未设置 groups，则为必需 |
| triggers | object/array | 用于替换当前触发器的触发器。 触发器只能定义 triggerid 属性。参数行为： - 如果未设置 groups 和 hosts，则为必需- 如果 maintenance_type=0（收集数据），则为支持 |
| event_names | object/array | 用于替换当前事件名称的事件名称。 参数行为： - 如果 maintenance_type=0（收集数据），则为支持 |
| tags | object/array | 用于替换当前标签的问题标签。 参数行为： - 如果Maintenance 对象的 maintenance_type 设置为“收集数据”，则为支持 |
| timeperiods | object/array | 用于替换当前时间段的维护时间段。 |
返回值
(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.