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
       }

参照

Time period

ソース

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

Documentation

maintenance.update

説明

パラメータ

戻り値

例

異なるホストの割り当て

参照

ソース