host.update

Apraksts

object host.update(object/array hosts)

Šī metode ļauj atjaunināt esošos hostus.

Šī metode ir pieejama tikai Admin un Super admin lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet Lietotāju lomas.

Parametri

(object/array) Atjaunināmie hosta rekvizīti.

Katram hostam jābūt definētam rekvizītam hostid, visi pārējie rekvizīti nav obligāti. Tiks atjaunināti tikai norādītie rekvizīti, visi pārējie paliks nemainīti.

Tomēr ņemiet vērā, ka, atjauninot hosta tehnisko nosaukumu, tiks atjaunināts arī hosta redzamais nosaukums (ja tas nav norādīts atsevišķi), izmantojot hosta tehniskā nosaukuma vērtību.

Papildus standarta hosta rekvizītiem metode pieņem šādus parametrus.

Parametrs Tips Apraksts
groups object/array Hostu grupas, ar kurām aizstāt pašreizējās hostu grupas, kurām hosts pieder.
Visu hostu grupu saites, kas pieprasījumā nav norādītas, tiks noņemtas.

Hostu grupām jābūt definētam tikai rekvizītam groupid.
interfaces object/array Hostu saskarnes, ar kurām aizstāt pašreizējās hostu saskarnes.
Visas saskarnes, kas pieprasījumā nav norādītas, tiks noņemtas.
tags object/array Hostu birkas, ar kurām aizstāt pašreizējās hostu birkas.
Visas birkas, kas pieprasījumā nav norādītas, tiks noņemtas.
inventory object Hosta inventarizācijas rekvizīti.
macros object/array Lietotāja makrosi, ar kuriem aizstāt pašreizējos lietotāja makrosus.
Visi makrosi, kas pieprasījumā nav norādīti, tiks noņemti.
templates object/array Veidnes, ar kurām aizstāt pašlaik piesaistītās veidnes.
Visām veidnēm, kas pieprasījumā nav norādītas, tiks tikai noņemta saite.

Veidnēm jābūt definētam tikai rekvizītam templateid.
templates_clear object/array Veidnes, kurām noņemt saiti un notīrīt no hosta.

Veidnēm jābūt definētam tikai rekvizītam templateid.

Atgrieztās vērtības

(object) Atgriež objektu, kas satur atjaunināto hostu ID zem hostids īpašības.

Piemēri

Hosta iespējošana

Iespējojiet hosta uzraudzību, tas ir, iestatiet tā statusu uz "0".

Pieprasījums:

{
    "jsonrpc": "2.0",
    "method": "host.update",
    "params": {
        "hostid": "10126",
        "status": 0
    },
    "id": 1
}

Atbilde:

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

Vairāku hostu iespējošana

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

Pieprasījums:

{
    "jsonrpc": "2.0",
    "method": "host.update",
    "params": [
        {
            "hostid": "10127",
            "status": 0
        },
        {
            "hostid": "10128",
            "status": 0
        }
    ],
    "id": 1
}

Atbilde:

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

Veidņu atsaistīšana

Atsaistīt un notīrīt divas veidnes no hosta.

Pieprasījums:

{
    "jsonrpc": "2.0",
    "method": "host.update",
    "params": {
        "hostid": "10126",
        "templates_clear": [
            {
                "templateid": "10124"
            },
            {
                "templateid": "10125"
            }
        ]
    },
    "id": 1
}

Atbilde:

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

Hosta makrosu atjaunināšana

Aizstājiet visus hosta makrosus ar diviem jauniem.

Pieprasījums:

{
    "jsonrpc": "2.0",
    "method": "host.update",
    "params": {
        "hostid": "10126",
        "macros": [
            {
                "macro": "{$PASS}",
                "value": "password"
            },
            {
                "macro": "{$DISC}",
                "value": "sda",
                "description": "Atjaunināts apraksts"
            }
        ]
    },
    "id": 1
}

Atbilde:

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

Hosta inventāra atjaunināšana

Mainiet inventāra režīmu un pievienojiet atrašanās vietu

Pieprasījums:

{
    "jsonrpc": "2.0",
    "method": "host.update",
    "params": {
        "hostid": "10387",
        "inventory_mode": 0,
        "inventory": {
            "location": "Latvia, Riga"
        }
    },
    "id": 1
}

Atbilde:

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

Hosta birku atjaunināšana

Aizstājiet visas hosta birkas ar jaunu birku.

Pieprasījums:

{
    "jsonrpc": "2.0",
    "method": "host.update",
    "params": {
        "hostid": "10387",
        "tags": {
            "tag": "os",
            "value": "rhel-7"
        }
    },
    "id": 1
}

Atbilde:

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

Atklāto hostu makrosu atjaunināšana

Pārveidojiet atklāšanas kārtulas izveidoto "automatic" makrosu par "manual" un nomainiet tā vērtību uz "new-value".

Pieprasījums:

{
    "jsonrpc": "2.0",
    "method": "host.update",
    "params": {
        "hostid": "10387",
        "macros": {
            "hostmacroid": "5541",
            "value": "new-value",
            "automatic": "0"
        }
    },
    "id": 1
}

Atbilde:

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

Hosta šifrēšanas atjaunināšana

Atjauniniet hostu "10590", lai tas izmantotu tikai PSK šifrēšanu savienojumiem no hosta uz Zabbix serveri, un nomainiet PSK identitāti un PSK atslēgu. Ņemiet vērā, ka hostam jābūt iepriekš konfigurētam PSK izmantošanai.

Pieprasījums:

{
    "jsonrpc": "2.0",
    "method": "host.update",
    "params": {
        "hostid": "10590",
        "tls_connect": 1,
        "tls_accept": 2,
        "tls_psk_identity": "PSK 002",
        "tls_psk": "e560cb0d918d26d31b4f642181f5f570ad89a390931102e5391d08327ba434e9"
    },
    "id": 1
}

Atbilde:

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

Skatiet arī

Avots

CHost::update() failā ui/include/classes/api/services/CHost.php.