map.update

Beschreibung

object map.update(object/array maps)

Mit dieser Methode können vorhandene Karten aktualisiert werden.

Diese Methode ist für Benutzer aller Typen verfügbar. Die Berechtigungen zum Aufrufen der Methode können in den Einstellungen der Benutzerrolle entzogen werden. Weitere Informationen finden Sie unter User roles.

Parameter

(object/array) Zu aktualisierende Karteneigenschaften.

Die Eigenschaft mapid muss für jede Karte definiert werden, alle anderen Eigenschaften sind optional. Nur die übergebenen Eigenschaften werden aktualisiert, alle anderen bleiben unverändert.

Zusätzlich zu den standardmäßigen Karteneigenschaften akzeptiert die Methode die folgenden Parameter.

Parameter Type Beschreibung
links array Kartenverknüpfungen, die die vorhandenen Verknüpfungen ersetzen.
selements array Kartenelemente, die die vorhandenen Elemente ersetzen.
urls array Karten-URLs, die die vorhandenen URLs ersetzen.
users array Kartenbenutzer-Freigaben, die die vorhandenen Elemente ersetzen.
userGroups array Freigaben für Karten-Benutzergruppen, die die vorhandenen Elemente ersetzen.
shapes array Kartenformen, die die vorhandenen Formen ersetzen.
lines array Kartenlinien, die die vorhandenen Linien ersetzen.

Um Kartenverknüpfungen zwischen neuen Kartenelementen zu erstellen, müssen Sie die selementid eines Elements auf einen beliebigen Wert setzen und dann diesen Wert verwenden, um in den Eigenschaften selementid1 oder selementid2 der Verknüpfungen auf dieses Element zu verweisen. Wenn das Element erstellt wird, wird dieser Wert durch die korrekte von Zabbix generierte ID ersetzt. Siehe Beispiel für map.create.

Rückgabewerte

(object) Gibt ein Objekt zurück, das die IDs der aktualisierten Maps unter der Eigenschaft sysmapids enthält.

Beispiele

Größe einer Karte ändern

Ändern Sie die Größe der Karte auf 1200x1200 Pixel.

Anfrage:

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

Antwort:

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

Eigentümer der Karte ändern

Nur für Admins und Super-Admins verfügbar.

Anfrage:

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

Antwort:

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

Siehe auch

Quelle

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