hosts.massupdate

Apraksts

object host.massupdate(object parameters)

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

Šī 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 host īpašībām metode pieņem šādus parametrus.

Parameter Type Description
hosts object/array Hosts, kas jāatjaunina.

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

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

Host grupām drīkst būt definēta tikai groupid īpašība.
interfaces object/array Host saskarnes, ar kurām aizstāt pašreizējās host saskarnes norādītajos hosts.
inventory object Host inventāra īpašības.

Host inventāra režīmu nevar atjaunināt, izmantojot inventory parametru; tā vietā izmantojiet inventory_mode.
macros object/array Lietotāja makro, ar kuriem aizstāt pašreizējos lietotāja makro norādītajos hosts.
templates object/array Veidnes, lai aizstātu pašlaik saistītās veidnes norādītajos hosts.

Veidnēm drīkst būt definēta tikai templateid īpašība.
templates_clear object/array Veidnes, kuras atsaistīt un notīrīt no norādītajiem hosts.

Veidnēm 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.