host.massupdate

Apraksts

object host.massupdate(object parameters)

Šī metode ļauj vienlaikus aizstāt vai noņemt saistītos objektus un atjaunināt vairāku hosts īpašības.

Šī metode ir pieejama tikai Admin un Super admin lietotāju tipiem. Tiesības izsaukt šo metodi var atsaukt lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā Lietotāju lomas.

Parametri

(object) Parametri, kas satur to hosts ID, kurus jāatjaunina, un īpašības, kas jāatjaunina.

Papildus standarta hosts īpašībām metode pieņem šādus parametrus.

Parameter Type Description
hosts object/array Hosts atjaunināšanai.

Hosts drīkst būt definēta tikai hostid īpašība.

Parameter behavior:
- required
groups object/array Host groups, ar ko aizstāt pašreizējās host grupas, kurām hosts pieder.

Host groups drīkst būt definēta tikai groupid īpašība.
interfaces object/array Host interfaces, ar ko aizstāt pašreizējās host interfaces norādītajiem hosts.
inventory object Host inventory īpašības.

Host inventory režīmu nevar atjaunināt, izmantojot inventory parametru; tā vietā izmantojiet inventory_mode.
macros object/array User macros, ar ko aizstāt pašreizējās lietotāja macros norādītajiem hosts.
templates object/array Templates, lai aizstātu pašlaik piesaistītās templates norādītajiem hosts.

Templates drīkst būt definēta tikai templateid īpašība.
templates_clear object/array Templates, ko atsaistīt un noņemt no norādītajiem hosts.

Templates drīkst būt definēta tikai templateid īpašība.

Atgrieztās vērtības

(object) Atgriež objektu, kas satur atjaunināto hosts ID hostids īpašībā.

Piemēri

Vairāku hosts iespējošana

Iespējojiet divu hosts uzraudzību, tas ir, iestatiet to statusu uz "0".

Pieprasījums:

{
    "jsonrpc": "2.0",
    "method": "host.massupdate",
    "params": {
        "hosts": [
            {
                "hostid": "69665"
            },
            {
                "hostid": "69666"
            }
        ],
        "status": 0
    },
    "id": 1
}

Atbilde:

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

Skatīt arī

Avots

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