Sidebar

zh:manual:api:reference:maintenance:update

更新

说明

object maintenance.update(object/array maintenances)

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

参数

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

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

另外见标准的维护属性,此方法接受如下参数。

属性 类型 描述
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 frontends/php/include/classes/api/services/CMaintenance.php.