You are viewing documentation for the development version, it may be incomplete.
Join our translation project and help translate Zabbix documentation into your native language.

host.create

Beschrijving

object host.create(object/array hosts)

Deze methode maakt het mogelijk om nieuwe hosts te maken.

Deze methode is alleen beschikbaar voor gebruikerstypes Admin en Superadmin. Rechten om de methode aan te roepen kunnen worden ingetrokken in de instellingen van gebruikersrollen. Zie Gebruikersrollen voor meer informatie.

Parameters

(object/array) Gastheren om te creëren.

Naast de standaard gastheereigenschappen, accepteert de methode de volgende parameters.

Parameter Type Beschrijving
groups object/array Gastheer groepen om de gastheer aan toe te voegen.

De gastheergroepen moeten de eigenschap groupid gedefinieerd hebben.

Gedrag van parameters:
- vereist
interfaces object/array Te creëren interfaces voor de gastheer.
tags object/array Gastheer tags.
templates object/array Aan de gastheer te koppelen sjablonen.

De sjablonen moeten de eigenschap templateid gedefinieerd hebben.
macros object/array Te creëren gebruikersmacro's voor de gastheer.
inventory object Eigenschappen van gastheer inventaris.

Retourwaarden

(object) Retourneert een object dat de ID's van de gemaakte hosts bevat onder de eigenschap hostids. De volgorde van de geretourneerde ID's komt overeen met de volgorde van de doorgegeven gastheren.

Voorbeelden

Een gastheer creëren

Maak een gastheer genaamd "Linux server" met een IP-interface en tags, voeg deze toe aan een groep, koppel een sjabloon eraan en stel de MAC-adressen in de gastheer-inventaris in.

Aanvraag:

{
           "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
       }

Antwoord:

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

Een gastheer creëren met SNMP-interface

Maak een gastheer genaamd "SNMP host" met een SNMPv3-interface met details.

Aanvraag:

{
           "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
       }

Antwoord:

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

Een host creëren met PSK-versleuteling

Maak een host genaamd "PSK host" met geconfigureerde PSK-versleuteling. Let op dat de host vooraf geconfigureerd moet zijn om PSK te gebruiken.

Aanvraag:

{
           "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
       }

Antwoord:

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

Creating a host monitored by a proxy

Create a host that will be monitored by proxy with ID "1".

Request:

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

Response:

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

Creating a host monitored by a proxy group

Create a host that will be monitored by proxy group with ID "1".

Request:

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

Response:

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

Zie ook

Bron

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