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
}

マップの所有者を変更

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

リクエスト:

{
    "jsonrpc": "2.0",
    "method": "map.update",
    "params": {
        "sysmapid": "9",
        "userid": "1"
    },
    "id": 1
}

レスポンス:

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

参照

ソース

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