map.update

説明

object map.update(object/array maps)

このメソッドは、既存のマップを更新するためのものです。

このメソッドは、すべてのタイプのユーザーが利用できます。メソッドの呼び出し権限は、ユーザーロールの設定で取り消すことができます。詳細はユーザーロールを参照してください。

パラメータ

(object/array) 更新するマップのプロパティ。

各マップには mapid プロパティを定義する必要があり、他のプロパティはオプションです。渡されたプロパティのみが更新され、他のプロパティは変更されません。

標準のマッププロパティに加えて、このメソッドは以下のパラメータを受け付けます。

パラメータ	型	説明
links	array	既存のリンクを置き換えるマップリンク。
selements	array	既存の要素を置き換えるマップ要素。
urls	array	既存のURLを置き換えるマップURL。
users	array	既存の要素を置き換えるマップユーザーの共有。
userGroups	array	既存の要素を置き換えるマップユーザーグループの共有。
shapes	array	既存の図形を置き換えるマップ図形。
lines	array	既存の線を置き換えるマップ線。

新しいマップ要素間でマップリンクを作成するには、要素の selementid に任意の値を設定し、この値をリンクの selementid1 または selementid2 プロパティでこの要素を参照するために使用する必要があります。要素が作成されると、この値は Zabbixによって生成された正しいIDに置き換えられます。map.createの例を参照してください。

戻り値

(object) sysmapidsプロパティの下で更新されたマップのIDを含むオブジェクトを返します。

例

マップのサイズ変更

マップのサイズを1200x1200ピクセルに変更します。

リクエスト:

{
           "jsonrpc": "2.0",
           "method": "map.update",
           "params": {
               "sysmapid": "8",
               "width": 1200,
               "height": 1200
           },
           "id": 1
       }

レスポンス:

{
           "jsonrpc": "2.0",
           "result": {
               "sysmapids": [
                   "8"
               ]
           },
           "id": 1
       }

マップの所有者を変更

管理者とスーパ管理者のみ利用可能です。