Documentation
更新维护期设置
描述
object maintenance.update(object/array maintenances)
此方法允许更新已存在的维护模式。
此方法仅适用于 管理员 和 超级管理员 用户类型。可以在用户角色中撤销调用该方法的权限设置。请参阅用户角色 了解更多信息。
参数
(object/array) 要更新的维护模式的属性。
每一个维护模式的maintenanceid属性必须被定义，其他所有属性均为可选。只有被传递的属性才会被更新，所有它属性保持不变。
除了标准维护属性，该方法接受以下内容参数。
| 参数 | 类型 | 描述 |
|---|---|---|
| groups | object/array | 主机组 替换当前组。 主机组必须仅定义 groupid 属性。参数行为: - 必需 如果 hosts 没有设置 |
| hosts | object/array | 主机 替换当前主机。 主机必须仅定义 hostid 属性。参数行为: - 必需 如果没有设置 groups |
| timeperiods | object/array | 维护时间段 替换当前周期。 |
| tags | object/array | 问题标签 替换当前标签。 参数行为: - 支持 如果维护对象的 maintenance_type设置为"有数据收集" |
| groupids (已弃用) |
array | 此参数已弃用，请改用 groups 。需要维护的主机组ID。 |
| hostids (已弃用) |
array | 此参数已弃用，请改用 hosts 。需要维护的主机ID。 |
返回值
(object)在maintenanceids属性中返回一个包含已被更新的维护模式的IDs的对象。
案例
指定不同的主机
将当前分配维护的主机替换为两台不同的主机。
请求：
{
"jsonrpc": "2.0",
"method": "maintenance.update",
"params": {
"maintenanceid": "3",
"hosts": [
{"hostid": "10085"},
{"hostid": "10084"}
]
},
"id": 1
}响应：
参见
来源
CMaintenance::update() in ui/include/classes/api/services/CMaintenance.php.