Documentation
Table of Contents
map.create
Descrição
object map.create(object/array maps)
Este método permite criar novos mapas.
Este método está disponível para usuários de qualquer tipo. As permissões para chamar o método podem ser revogadas nas configurações de função do usuário. Consulte Funções de usuário para obter mais informações.
Parâmetros
(object/array) Mapas para criar.
Além das propriedades padrão do mapa, o método aceita os seguintes parâmetros.
| Parâmetro | Tipo | Descrição |
|---|---|---|
| links | array | Mapa links a ser criado no mapa. |
| selements | array | Mapa elementos a ser criado no mapa. |
| urls | array | Mapa URLs a ser criado no mapa. |
| users | array | Mapeie os compartilhamentos de usuário a serem criados no mapa. |
| userGroups | array | Map user group shares to be created on the map. |
| shapes | array | Mapa shapes a ser criado no mapa. |
| lines | array | Mapa linhas a ser criado no mapa. |
Para criar links de mapa, você precisará definir um elemento de mapa selementid para um valor arbitrário e, em seguida, usar esse valor para fazer referência a esse elemento nas propriedades selementid1 ou selementid2 dos links. Quando o elemento for criado, este valor será substituído pelo ID correto gerado pelo Zabbix. Veja exemplo.
Valores de retorno
(object) Retorna um objeto contendo os IDs dos mapas criados na propriedade sysmapids. A ordem dos IDs retornados corresponde à ordem dos mapas passados.
Exemplos
Criar um mapa vazio
Criar um mapa sem elementos.
Request:
{
"jsonrpc": "2.0",
"method": "map.create",
"params": {
"name": "Map",
"width": 600,
"height": 600
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Response:
Criar um mapa de host
Crie um mapa com dois elementos hospedeiros e um link entre eles. Observe o uso de valores temporários "selementid1" e "selementid2" no objeto de link do mapa para fazer referência aos elementos do mapa.
Request:
{
"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
}Response:
Criar um trigger mapa
Crie um mapa com elemento de trigger, que contém duas triggers.
Request:
{
"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
}Response:
Compartilhamento de mapa
Crie um mapa com dois tipos de compartilhamento (usuário e grupo de usuários).
Request:
{
"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
}Response:
Formas do mapa
Criar um mapa com o título do nome do mapa.
Request:
{
"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
}Response:
Linhas do mapa
Crie uma linha de mapa..
Request:
{
"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
}Response:
Veja também
Fonte
CMap::create() in ui/include/classes/api/services/CMap.php.