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 Admin e Superadministrador tipos de usuário. As permissões para chamar o método podem ser revogadas na função de usuário definições. Veja Usuário funções Para maiores informações.

Parâmetros

(objeto/array) Hosts para criar.

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

|Parâmetro|Tipo|Descrição| |---------|----------------------------------- ------------|-----------| |grupos
(obrigatório)|objeto/matriz|Host grupos ao qual adicionar o host.

Os grupos de hosts devem ter a propriedade groupid definida.| |interfaces|object/array|Interfaces a ser criado para o host.| |tags|object/array|Host tags.| |templates|object/array|Templates a serem vinculados ao host.

Os templates devem ter a propriedade templateid definida.| |macros|object/array|Macros do usuário a serem criados para o host.| |inventário|objeto|Host inventário propriedades.|

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 "servidor Linux" com uma interface IP e tags, adicione a um grupo, vincule um modelo a ele e defina os endereços MAC no inventário do hospedeiro.

Solicitação:

{
           "jsonrpc": "2.0",
           "método": "host.create",
           "parâmetros": {
               "host": "Servidor Linux",
               "interfaces": [
                   {
                       "tipo 1,
                       "principal": 1,
                       "useip": 1,
                       "ip": "192.168.3.1",
                       "dns": "",
                       "porta": "10050"
                   }
               ],
               "grupos": [
                   {
                       "groupid": "50"
                   }
               ],
               "Tag": [
                   {
                       "tag": "Nome do host",
                       "value": "Servidor Linux"
                   }
               ],
               "modelos": [
                   {
                       "templateid": "20045"
                   }
               ],
               "macros": [
                   {
                       "macro": "{$USER_ID}",
                       "valor": "123321"
                   },
                   {
                       "macro": "{$USER_LOCATION}",
                       "valor": "0:0:0",
                       "description": "coordenadas de latitude, longitude e altitude"
                   }
               ],
               "modo_inventário": 0,
               "inventário": {
                   "macaddress_a": "01234",
                   "macaddress_b": "56768"
               }
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Resposta:

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

Criando um host com interface SNMP

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

Solicitação:

{
           "jsonrpc": "2.0",
           "método": "host.create",
           "parâmetros": {
               "host": "Host SNMP",
               "interfaces": [
                   {
                       "tipo 2,
                       "principal": 1,
                       "useip": 1,
                       "ip": "127.0.0.1",
                       "dns": "",
                       "porta": "161",
                       "detalhes": {
                           "versão": 3,
                           "em massa": 0,
                           "securityname": "mysecurityname",
                           "contextname": "",
                           "nível de segurança": 1
                       }
                   }
               ],
               "grupos": [
                   {
                       "groupid": "4"
                   }
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Resposta:

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

Creating a host with PSK encryption configured

Create a host called "PSK host" with PSK encryption configured only for connections from Zabbix server to host. Note that the Zabbix agent that is installed on the host has to be configured to use PSK.

Request:

{
           "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_connect": 2,
               "tls_psk_identity": "PSK 001",
               "tls_psk": "af8ced32dfe8714e548694e2d29e1a14ba6fa13f216cb35c19d0feb1084b0429"
           },
           "id": 1
       }

Response:

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

Veja também

Fonte

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