更新
描述
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 设置为“采集数据”时，支持该参数 |
返回值
(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.