map.create

Description

object map.create(object/array maps)

Cette méthode permet de créer de nouvelles cartes.

Cette méthode est disponible à tous les types d'utilisateurs. Les autorisations d'appeler la méthode peuvent être révoquées dans les paramètres du le rôle d'utilisateur. Voir Rôles Utilisateur pour plus d'informations.

Paramètres

(object/array) Cartes à créer.

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

Paramètre Type Description
links array Liens de carte à créer sur la carte.
selements array Éléments de carte à créer sur la carte.
urls array URLs de carte à créer sur la carte.
users array Partages d'utilisateur de carte à créer sur la carte.
userGroups array Partages de groupe d'utilisateurs de carte à créer sur la carte.
shapes array Formes de carte à créer sur la carte.
lines array Lignes de carte à créer sur la carte.

Pour créer des liens de carte, il est nécessaire de définir un élément de carte selementid sur une valeur arbitraire, puis d'utiliser cette valeur pour référencer cet élément dans les propriétés des liens selementid1 ou selementid2. Lors de la création de l'élément, cette valeur sera remplacée par l'ID correct généré par Zabbix. Voir l'exemple.

Valeurs retournées

(object) Retourne un objet contenant les identifiants des cartes créées sous la propriété sysmapids. L'ordre des ID retournés correspond à l'ordre des cartes transmises.

Exemples

Créer une carte vide

Créer une carte sans élément.

Requête :

{
        "jsonrpc": "2.0",
        "method": "map.create",
        "params": {
        "name": "Map",
        "width": 600,
        "height": 600
        },
        "auth": "038e1d7b1735c6a5436ee9eae095879e",
        "id": 1
       }

Réponse :

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

Créer une carte d'hôte

Créer une carte avec deux éléments hôtes et un lien entre eux. A noter : l'utilisation de valeurs temporaires "selementid1" et "selementid2" dans l'objet de lien de carte pour faire référence à des éléments de carte.

Requête :

{
        "jsonrpc": "2.0",
        "method": "map.create",
        "params": {
        "name": "Host map",
        "width": 600,
        "height": 600,
        "selements": [
        {
        "selementid": "1",
        "elements": [
        {"hostid": "1033"}
        ],
        "elementtype": 0,
        "iconid_off": "2"
        },
       
        {
        "selementid": "2",
        "elements": [
        {"hostid": "1037"}
        ],
        "elementtype": 0,
        "iconid_off": "2"
        }
        ],
        "links": [
        {
        "selementid1": "1",
        "selementid2": "2"
        }
        ]
        },
        "auth": "038e1d7b1735c6a5436ee9eae095879e",
        "id": 1
       }

Réponse :

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

Créer une carte de déclencheurs

Créer une carte avec un élément déclencheur, qui contient deux déclencheurs.

Requête :

{
        "jsonrpc": "2.0",
        "method": "map.create",
        "params": {
        "name": "Trigger map",
        "width": 600,
        "height": 600,
        "selements": [
        {
        "elements": [
        {"triggerid": "12345"},
        {"triggerid": "67890"}
        ],
        "elementtype": 2,
        "iconid_off": "2"
        }
        ]
        },
        "auth": "038e1d7b1735c6a5436ee9eae095879e",
        "id": 1
       }

Réponse :

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

Partager une carte

Créer une carte avec deux types de partage (utilisateur et groupe d'utilisateurs).

Requête :

{
        "jsonrpc": "2.0",
        "method": "map.create",
        "params": {
        "name": "Map sharing",
        "width": 600,
        "height": 600,
        "users": [
        {
        "userid": "4",
        "permission": "3"
        }
        ],
        "userGroups": [
        {
        "usrgrpid": "7",
        "permission": "2"
        }
        ]
        },
        "auth": "038e1d7b1735c6a5436ee9eae095879e",
        "id": 1
       }

Réponse :

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

Formes de carte

Créer une carte avec un titre.

Requête :

{
        "jsonrpc": "2.0",
        "method": "map.create",
        "params": {
        "name": "Host map",
        "width": 600,
        "height": 600,
        "shapes": [
        {
        "type": 0,
        "x": 0,
        "y": 0,
        "width": 600,
        "height": 11,
        "text": "{MAP.NAME}"
        }
        ]
        },
        "auth": "038e1d7b1735c6a5436ee9eae095879e",
        "id": 1
       }

Réponse :

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

Ligne de carte

Créer une ligne de carte.

Requête :

{
        "jsonrpc": "2.0",
        "method": "map.create",
        "params": {
        "name": "Map API lines",
        "width": 500,
        "height": 500,
        "lines": [
        {
        "x1": 30,
        "y1": 10,
        "x2": 100,
        "y2": 50,
        "line_type": 1,
        "line_width": 10,
        "line_color": "009900"
        }
        ]
        },
        "auth": "038e1d7b1735c6a5436ee9eae095879e",
        "id": 1
       }

Réponse :

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

Voir également

Source

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