hostprototype.update

Опис

object hostprototype.update(object/array hostPrototypes)

Овај метод омогућава ажурирање постојећих прототипова домаћина.

Ова метода је доступна само типовима Админ и Супер админусер. Дозволе за позивање методе могу се опозвати у подешавањима улога корисника. Погледајте Userroles за више информација.

Параметри

(object/array) Својства прототипа хоста која треба ажурирати.

Својство hostid мора бити дефинисано за сваки прототип хоста, сва остала својства су опционална. Ажурираће се само прослеђена својства, сва остала ће остати непромењена.

Поред стандардних својстава прототипа хоста, метод прихвата следеће параметре.

Parameter Type Description
groupLinks array Групне везе да би се замениле тренутне групне везе на прототипу хоста.

Понашање параметра:
- само за читање за наслеђене објекте
groupPrototypes array Прототипови група да би се заменили постојећи прототипови група на прототипу хоста.

Сви прототипови група који нису наведени у захтеву биће уклоњени.

Понашање параметра:
- само за читање за наслеђене објекте
macros object/array Кориснички макрои да би се заменили тренутни кориснички макрои.
Сви макрои који нису наведени у захтеву биће уклоњени.
tags object/array Ознаке прототипа домаћина да би се замениле тренутне ознаке.
Све ознаке које нису наведене у захтеву биће уклоњене.

Понашање параметра:
- само за читање за наслеђене објекте
interfaces object/array Прототип домаћина прилагођени интерфејси да би се заменили тренутни интерфејси.
Објекат прилагођеног интерфејса треба да садржи све своје параметре.
Сви интерфејси који нису наведени у захтеву биће уклоњени.

Понашање параметра:
- подржано ако је прилагођени_интерфејси од Објекат прототипа домаћина подешено на "користи прилагођене интерфејсе прототипова домаћина"
- само за читање за наслеђене објекте
templates object/array Шаблони да би се заменили тренутно повезани шаблони.

Шаблони морају имати дефинисано само својство templateid.

Повратне вредности

(object) Враћа објекат који садржи ID-ијеве ажурираних прототипова домаћина под својством hostids.

Примери

Онемогућавање прототипа домаћина

Онемогућите прототип домаћина, односно поставите његов статус на "1".

Request:

{
            "jsonrpc": "2.0",
            "method": "hostprototype.update",
            "params": {
            "hostid": "10092",
            "status": 1
            },
            "id": 1
       }

Одговор:

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

Ажурирање ознака прототипа домаћина

Замените ознаке прототипа домаћина новима.

Request:

{
            "jsonrpc": "2.0",
            "method": "hostprototype.update",
            "params": {
            "hostid": "10092",
            "tags": [
            {
            "tag": "datacenter",
            "value": "{#DATACENTER.NAME}"
            },
            {
            "tag": "instance-type",
            "value": "{#INSTANCE_TYPE}"
            }
            ]
            },
            "id": 1
       }

Одговор:

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

Ажурирање прилагођених интерфејса прототипа домаћина

Замените наслеђене интерфејсе са прилагођеним интерфејсима прототипа домаћина.

Request:

{
            "jsonrpc": "2.0",
            "method": "hostprototype.update",
            "params": {
            "hostid": "10092",
            "custom_interfaces": "1",
            "interfaces": [
            {
            "main": "1",
            "type": "2",
            "useip": "1",
            "ip": "127.0.0.1",
            "dns": "",
            "port": "161",
            "details": {
            "version": "2",
            "bulk": "1",
            "community": "{$SNMP_COMMUNITY}"
            }
            }
            ]
            },
            "id": 1
       }

Одговор:

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

Такође погледајте

Извор

CHostPrototype::update() in ui/include/classes/api/services/CHostPrototype.php.