host.create

Опис

object host.create(object/array hosts)

Цей метод дозволяє створювати нові хости.

Цей метод доступний лише для користувачів типу Admin і Super admin. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. Ролі користувача для отримання додаткової інформації.

Параметри

(object/array) Hosts to create.

Окрім стандартних властивостей хоста, метод приймає такі параметри.

Параметр	Тип	Опис
groups (обов’язково)	object/array	Хост групи, до яких потрібно додати хост. Групи хостів повинні мати визначено властивість `groupid`.
інтерфейси	об’єкт/масив	Інтерфейси, який буде створено для хосту.
теги	об'єкт/масив	Хост теги.
шаблони	об’єкт/масив	Шаблони, які потрібно зв’язати з хостом. Шаблони повинні мати властивість `templateid`.
макроси	об’єкт/масив	Макроси користувача, який буде створено для хосту.
інвентаризація	об'єкт	Властивості хосту інвентаризація.

Повернуті значення

(object) Повертає об’єкт, що містить ідентифікатори створених хостів у властивості hostids. Порядок повернених ідентифікаторів відповідає порядку переданих хостів.

Приклади

Створення хоста

Створіть хост під назвою «Linux server» з IP-інтерфейсом і тегами, додайте його до групи, зв’яжіть із ним шаблон і встановіть MAC-адреси в інвентарі хостів.

Запит:

{
           "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"
               }
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Відповідь:

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

Створення хосту з інтерфейсом SNMP

Створіть хост під назвою «Хост SNMP» з інтерфейсом SNMPv3 із детальною інформацією.

Запит:

{
           "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"
                   }
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Відповідь:

{
           "jsonrpc": "2.0",
           "result": {
               "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
       }

Дивись також

Джерело

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

Documentation