map.update

説明

object map.update(object/array maps)

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

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

パラメータ

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

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

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

パラメータ タイプ 説明
links array linksをマップして、既存のリンクを置き換えます。
selements array elementsをマップして、既存の要素を置き換えます。
urls array URLsをマップして、既存のURLを置き換えます。
users array user共有をマップして、既存の要素を置き換えます
userGroups array user groupの共有をマップして、既存の要素を置き換えます。
shapes array shapesをマップして、既存のシェイプを置き換えます。
lines array linesをマップして、既存の行を置き換えます。

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

戻り値

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

例

マップのサイズ変更

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

Request:

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

Response:

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

マップの所有者変更

管理者とスーパー管理者のみが利用できます。

Request:

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

Response:

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

参照

ソース

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