这是原厂英文文档的翻译页面. 欢迎帮助我们 完善文档.
2022 Zabbix中国峰会
2022 Zabbix中国峰会

更新

说明

object maintenance.update(object/array maintenances)

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

参数

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

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

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

属性 类 描述
groupids array 要替换的当前主机组的主机组IDs。
hostids array 要替换当前主机的主机IDs。
timeperiods array 要替换当前维护模式时间周期的时间周期。

<note important>每一个维护模式至少一个主机或者一个主机组被定义。 :::

返回值

(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.