更新维护期设置
描述
object maintenance.update(object/array maintenances)
此方法允许更新已存在的维护模式。
此方法仅适用于管理员和超级管理员用户类型。可以在用户角色设置中撤销调用该方法的权限。了解更多信息请参见用户角色。
参数
(object/array)
要更新的维护模式的属性。
每一个维护模式的maintenanceid
属性必须被定义,其他所有属性均为可选。只有被传递的属性才会被更新,所有它属性保持不变。
另外见standard maintenance properties,此方法接受如下参数。
Parameter | Type | Description |
---|---|---|
groupids | array | 要替换的当前主机组的主机组IDs。 |
hostids | array | 要替换当前主机的主机IDs。 |
timeperiods | array | 要替换当前维护模式时间周期的时间周期。 |
每一个维护模式至少一个主机或者一个主机组被定义。
返回值
(object)
在maintenanceids
属性中返回一个包含已被更新的维护模式的IDs的对象。
案例
指定不同的主机
用两个不同的主机替换当前分配给维护“3”的主机。
请求:
{
"jsonrpc": "2.0",
"method": "maintenance.update",
"params": {
"maintenanceid": "3",
"hostids": [
"10085",
"10084"
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}
返回:
{
"jsonrpc": "2.0",
"result": {
"maintenanceids": [
"3"
]
},
"id": 1
}
参见
来源
CMaintenance::update() in ui/include/classes/api/services/CMaintenance.php.