更新维护期设置

描述

object maintenance.update(object/array maintenances)

此方法允许更新已存在的维护模式。

此方法仅适用于管理员超级管理员用户类型。可以在用户角色设置中撤销调用该方法的权限。了解更多信息请参见用户角色

参数

(object/array)要更新的维护模式的属性。

每一个维护模式的maintenanceid属性必须被定义,其他所有属性均为可选。只有被传递的属性才会被更新,所有它属性保持不变。

另外见standard maintenance properties,此方法接受如下参数。

ParameterTypeDescription
groupidsarray要替换的当前主机组的主机组IDs。
hostidsarray要替换当前主机的主机IDs。
timeperiodsarray要替换当前维护模式时间周期的时间周期。

每一个维护模式至少一个主机或者一个主机组被定义。

返回值

(object)maintenanceids属性中返回一个包含已被更新的维护模式的IDs的对象。

案例

指定不同的主机

用两个不同的主机替换当前分配给维护“3”的主机。

请求:

  1. {
  2. "jsonrpc": "2.0",
  3. "method": "maintenance.update",
  4. "params": {
  5. "maintenanceid": "3",
  6. "hostids": [
  7. "10085",
  8. "10084"
  9. ]
  10. },
  11. "auth": "038e1d7b1735c6a5436ee9eae095879e",
  12. "id": 1
  13. }

返回:

  1. {
  2. "jsonrpc": "2.0",
  3. "result": {
  4. "maintenanceids": [
  5. "3"
  6. ]
  7. },
  8. "id": 1
  9. }

参见

来源

CMaintenance::update() in ui/include/classes/api/services/CMaintenance.php.