map.update

Description

object map.update(object/array maps)

Cette méthode permet de mettre à jour des cartes existantes.

Cette méthode est disponible pour les utilisateurs de tout type. Les autorisations d'appeler la méthode peuvent être révoquées dans les paramètres du rôle utilisateur. Voir User roles pour plus d'informations.

Paramètres

(object/array) Propriétés de la carte à mettre à jour.

La propriété mapid doit être définie pour chaque carte, toutes les autres propriétés sont facultatives. Seules les propriétés transmises seront mises à jour, toutes les autres resteront inchangées.

En plus des propriétés de carte standard, la méthode accepte les paramètres suivants.

Paramètre Type Description
links array Liens de carte remplaçant les liens existants.
selements array Éléments de carte remplaçant les éléments existants.
urls array URL de carte remplaçant les URL existantes.
users array Partages d’utilisateur de carte remplaçant les éléments existants.
userGroups array Partages de groupe d’utilisateurs de carte remplaçant les éléments existants.
shapes array Formes de carte remplaçant les formes existantes.
lines array Lignes de carte remplaçant les lignes existantes.

Pour créer des liens de carte entre de nouveaux éléments de carte, vous devrez définir le selementid d’un élément sur une valeur arbitraire, puis utiliser cette valeur pour référencer cet élément dans les propriétés selementid1 ou selementid2 des liens. Lorsque l’élément est créé, cette valeur sera remplacée par l’ID correct généré par Zabbix. Voir l’exemple pour map.create.

Valeurs retournées

(object) Retourne un objet contenant les identifiants des cartes mises à jour sous la propriété sysmapids.

Exemples

Redimensionner une carte

Modifiez la taille de la carte à 1200x1200 pixels.

Requête:

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

Réponse :

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

Changer le propriétaire de la carte

Disponible uniquement pour les administrateurs et les super administrateurs.

Requête :

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

Réponse :

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

Voir également

Source

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