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. Veja Funções de usuário para mais informações.
Parâmetros
(object/array) Mapas a serem criados.
Além das propriedades padrão do mapa, o método aceita os seguintes parâmetros.
| Parâmetro | Tipo | Descrição |
|---|---|---|
| links | array | Links do mapa a serem criados no mapa. |
| selements | array | Elementos do mapa a serem criados no mapa. |
| urls | array | URLs do mapa a serem criadas no mapa. |
| users | array | Compartilhamentos de usuário do mapa a serem criados no mapa. |
| userGroups | array | Compartilhamentos de grupo de usuários do mapa a serem criados no mapa. |
| shapes | array | Formas do mapa a serem criadas no mapa. |
| lines | array | Linhas do mapa a serem criadas no mapa. |
Para criar links de mapa, você precisará definir um selementid de elemento de mapa para um valor arbitrário e, em seguida, usar esse valor para referenciar esse elemento nas propriedades selementid1 ou selementid2 dos links. Quando o elemento for criado, esse valor será substituído pelo ID correto gerado pelo Zabbix. Veja o 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
Crie um mapa sem elementos.
{
"jsonrpc": "2.0",
"method": "map.create",
"params": {
"name": "Map",
"width": 600,
"height": 600
},
"id": 1
}Resposta:
Criar um mapa de hosts
Crie um mapa com dois elementos de host e um link entre eles. Observe o uso de valores temporários "selementid1" e "selementid2" no objeto de link do mapa para se referir aos elementos do mapa.
{
"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"
}
]
},
"id": 1
}Resposta:
Criar um mapa de trigger
Crie um mapa com um elemento de trigger, que contém dois triggers.
{
"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"
}
]
},
"id": 1
}Resposta:
Compartilhamento de mapa
Crie um mapa com dois tipos de compartilhamento (usuário e grupo de usuários).
{
"jsonrpc": "2.0",
"method": "map.create",
"params": {
"name": "Map sharing",
"width": 600,
"height": 600,
"users": [
{
"userid": "4",
"permission": "3"
}
],
"userGroups": [
{
"usrgrpid": "7",
"permission": "2"
}
]
},
"id": 1
}Resposta:
Formas do mapa
Crie um mapa com o título do nome do mapa.
{
"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}"
}
]
},
"id": 1
}Resposta:
Linhas do mapa
Crie uma linha de mapa.
{
"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"
}
]
},
"id": 1
}Resposta:
Veja também
- Elemento de mapa
- Link de mapa
- URL de mapa
- Usuário de mapa
- Grupo de usuários de mapa
- Forma de mapa
- Linha de mapa
Fonte
CMap::create() em ui/include/classes/api/services/CMap.php.