Sidebar

Zabbix Summit 2022
Register for Zabbix Summit 2022

maintenance.update

説明

object maintenance.update(object/array maintenances)

このメソッドで、既存のメンテナンスを更新できます。

このメソッドはAdminおよびSuper adminユーザータイプでのみ使用できます。 メソッドを呼び出す権限は、ユーザーロール設定で取り消すことができます。 詳細についてはユーザーの役割を参照してください。

パラメータ

(object/array) 更新されるメンテナンスプロパティ

maintenanceidプロパティは、メンテナンスごとに定義する必要があります。すべてのプロパティはオプションです。 渡されたプロパティのみが更新され、他のプロパティは変更されません。

このメソッドは標準のメンテナンスプロパティに加えて、次のパラメーターを受け入れます。

パラメータ タイプ 説明
groups object/array ホストgroupsを使用して、現在のグループを置き換えます。

ホストグループにはgroupidプロパティを定義する必要があります。
hosts object/array ホスト は現在のホストを置き換えます。

ホストにはhostidプロパティが定義されている必要があります。
timeperiods object/array 現在のメンテンナンス期間を置き換えるための期間
tags object/array 障害タグで現在のタグを置き換えます。

メンテナンスごとに、少なくとも1つのホストまたはホストグループを定義する必要があります。

戻り値

(object) maintenanceidsプロパティの下で更新されたメンテナンスのIDを含むオブジェクトを返します。

異なるホストの割り当て

現在メンテナンスに割り当てられているホストを2つの異なるホストに置き換えます。

Request:

{
           "jsonrpc": "2.0",
           "method": "maintenance.update",
           "params": {
               "maintenanceid": "3",
               "hosts": [
                   {"hostid": "10085"},
                   {"hostid": "10084"}
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Response:

{
           "jsonrpc": "2.0",
           "result": {
               "maintenanceids": [
                   "3"
               ]
           },
           "id": 1
       }

参照

ソース

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