map.update

説明

object map.update(object/array maps)

このメソッドでは、既存のマップを更新できます。

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

パラメータ

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

各マップでは mapid プロパティを定義する必要があり、その他のプロパティはすべて 任意です。渡されたプロパティのみが更新され、その他はすべて 変更されません。

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

パラメータ Type 説明
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.