hostprototype.update

Apraksts

object hostprototype.update(object/array hostPrototypes)

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

Šī 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āmo hostu prototipu īpašības.

Katram hosta prototipam jābūt definētai hostid īpašībai, visas pārējās īpašības nav obligātas. Tiks atjauninātas tikai nodotās īpašības, visas pārējās paliks nemainītas.

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

Parametrs Tips Apraksts
groupLinks array Grupu saites, ar kurām aizstāt pašreizējās grupu saites hosta prototipā.

Parametra darbība:
- tikai lasāms mantotiem objektiem
groupPrototypes array Grupu prototipi, ar kuriem aizstāt esošos grupu prototipus hosta prototipā.

Visi grupu prototipi, kas pieprasījumā nav norādīti, tiks noņemti.

Parametra darbība:
- tikai lasāms mantotiem objektiem
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.
tags object/array Hosta prototipa birkas, ar kurām aizstāt pašreizējās birkas.
Visas birkas, kas pieprasījumā nav norādītas, tiks noņemtas.

Parametra darbība:
- tikai lasāms mantotiem objektiem
interfaces object/array Hosta prototipa pielāgotās saskarnes, ar kurām aizstāt pašreizējās saskarnes.
Pielāgotās saskarnes objektam jāietver visi tā parametri.
Visas saskarnes, kas pieprasījumā nav norādītas, tiks noņemtas.

Parametra darbība:
- atbalstīts, ja Hosta prototipa objekta custom_interfaces ir iestatīts uz "use host prototypes custom interfaces"
- tikai lasāms mantotiem objektiem
templates object/array Veidnes, ar kurām aizstāt pašlaik piesaistītās veidnes.

Veidnēm jābūt definētai tikai templateid īpašībai.

Atgrieztās vērtības

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

Piemēri

Hosta prototipa atspējošana

Atspējojiet hosta prototipu, tas ir, iestatiet tā statusu uz "1".

Pieprasījums:

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

Atbilde:

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

Hosta prototipa tagu atjaunināšana

Aizstājiet hosta prototipa tagus ar jauniem.

Pieprasījums:

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

Atbilde:

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

Hosta prototipa pielāgoto saskarņu atjaunināšana

Aizstājiet mantotās saskarnes ar hosta prototipa pielāgotajām saskarnēm.

Pieprasījums:

{
    "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
}

Atbilde:

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

Skatīt arī

Avots

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