map.update

説明

object map.update(object/array maps)

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

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

パラメータ

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

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

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

Parameter Type Description
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.