Documentation

Table of Contents

host.create

host.create

Descrição

object host.create(object/array hosts)

Este método permite criar novos hosts.

Este método está disponível apenas para os tipos de usuário Admin e Super admin. 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) Hosts a serem criados.

Além das propriedades padrão do host, o método aceita os seguintes parâmetros.

Parâmetro	Tipo	Descrição
groups	object/array	Grupos de hosts aos quais o host será adicionado. Os grupos de hosts devem ter apenas a propriedade `groupid` definida. Comportamento do parâmetro: - obrigatório
interfaces	object/array	Interfaces a serem criadas para o host.
tags	object/array	Tags do host.
templates	object/array	Templates a serem vinculados ao host. Os templates devem ter apenas a propriedade `templateid` definida.
macros	object/array	Macros de usuário a serem criadas para o host.
inventory	object	Propriedades do inventário do host.

Valores de retorno

(object) Retorna um objeto contendo os IDs dos hosts criados sob a propriedade hostids. A ordem dos IDs retornados corresponde à ordem dos hosts passados.

Exemplos

Criando um host

Crie um host chamado "Linux server" com uma interface IP e tags, adicione-o a um grupo, vincule um template a ele e defina os endereços MAC no inventário do host.

Requisição:

{  "jsonrpc": "2.0",  "method": "host.create",  "params": {  "host": "Linux server",  "interfaces": [  {  "type": 1,  "main": 1,  "useip": 1,  "ip": "192.168.3.1",  "dns": "",  "port": "10050"  }  ],  "groups": [  {  "groupid": "50"  }  ],  "tags": [  {  "tag": "host-name",  "value": "linux-server"  }  ],  "templates": [  {  "templateid": "20045"  }  ],  "macros": [  {  "macro": "{$USER_ID}",  "value": "123321"  },  {  "macro": "{$USER_LOCATION}",  "value": "0:0:0",  "description": "latitude, longitude and altitude coordinates"  }  ],  "inventory_mode": 0,  "inventory": {  "macaddress_a": "01234",  "macaddress_b": "56768"  }  },  "id": 1 }

Resposta:

{  "jsonrpc": "2.0",  "result": {  "hostids": [  "107819"  ]  },  "id": 1 }

Criando um host com interface SNMP

Crie um host chamado "SNMP host" com uma interface SNMPv3 com detalhes.

Request:

{  "jsonrpc": "2.0",  "method": "host.create",  "params": {  "host": "SNMP host",  "interfaces": [  {  "type": 2,  "main": 1,  "useip": 1,  "ip": "127.0.0.1",  "dns": "",  "port": "161",  "details": {  "version": 3,  "bulk": 0,  "securityname": "mysecurityname",  "contextname": "",  "securitylevel": 1  }  }  ],  "groups": [  {  "groupid": "4"  }  ]  },  "id": 1 }

Resposta:

{  "jsonrpc": "2.0",  "result": {  "hostids": [  "10658"  ]  },  "id": 1 }

Criando um host com criptografia PSK

Crie um host chamado "PSK host" com criptografia PSK configurada. Observe que o host deve ser pré-configurado para usar PSK.

Requisição:

{  "jsonrpc": "2.0",  "method": "host.create",  "params": {  "host": "PSK host",  "interfaces": [  {  "type": 1,  "ip": "192.168.3.1",  "dns": "",  "port": "10050",  "useip": 1,  "main": 1  }  ],  "groups": [  {  "groupid": "2"  }  ],  "tls_accept": 2,  "tls_connect": 2,  "tls_psk_identity": "PSK 001",  "tls_psk": "1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952"  },  "id": 1 }

Resposta:

{  "jsonrpc": "2.0",  "result": {  "hostids": [  "10590"  ]  },  "id": 1 }

Criando um host monitorado por um proxy

Crie um host que será monitorado pelo proxy com ID "1".

Requisição:

{  "jsonrpc": "2.0",  "method": "host.create",  "params": {  "host": "Host monitored by proxy",  "groups": [  {  "groupid": "2"  }  ],  "monitored_by": 1,  "proxyid": 1  },  "id": 1 }

Resposta:

{  "jsonrpc": "2.0",  "result": {  "hostids": [  "10591"  ]  },  "id": 1 }

Criando um host monitorado por um grupo de proxy

Crie um host que será monitorado por um grupo de proxy com ID "1".

Requisição:

{  "jsonrpc": "2.0",  "method": "host.create",  "params": {  "host": "Host monitored by proxy group",  "groups": [  {  "groupid": "2"  }  ],  "monitored_by": 2,  "proxy_groupid": 1  },  "id": 1 }

Resposta:

{  "jsonrpc": "2.0",  "result": {  "hostids": [  "10592"  ]  },  "id": 1 }

Veja também

Fonte

CHost::create() em ui/include/classes/api/services/CHost.php.