Documentation
Table of Contents
map.create
Description
object map.create(object/array maps)
Cette méthode permet de créer de nouvelles cartes.
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éments.
Requête :
{
"jsonrpc": "2.0",
"method": "map.create",
"params": {
"name": "Map",
"width": 600,
"height": 600
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Réponse :
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 :
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 :
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 :
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 :
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 :
Voir également
- Elément de carte
- Lien de carte
- URL de carte
- Utilisateur de carte
- Groupe d'utilisateurs de carte
- Forme de carte
- Ligne de carte
Source
CMap::create() dans frontends/php/include/classes/api/services/CMap.php.