hostinterface.massremove

Description

object hostinterface.massremove(object parameters)

This method allows to remove host interfaces from the given hosts.

This method is only available to Admin and Super admin user types. Permissions to call the method can be revoked in user role settings. See User roles for more information.

Parameters

(object) Parameters containing the IDs of the hosts to be updated and the interfaces to be removed.

Parameter Type Description
hostids
(required)		 string/array IDs of the hosts to be updated.
interfaces
(required)		 object/array Host interfaces to remove from the given hosts.

The host interface object must have the ip, dns and port properties defined

Valori di ritorno

(object) Restituisce un oggetto contenente gli ID delle interfacce host eliminate sotto la proprietà interfaceids.

Esempi

Removing interfaces

Remove the "127.0.0.1" SNMP interface from two hosts.

Request:

{
    "jsonrpc": "2.0",
    "method": "hostinterface.massremove",
    "params": {
        "hostids": [
            "30050",
            "30052"
        ],
        "interfaces": {
            "dns": "",
            "ip": "127.0.0.1",
            "port": "161"
        }
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}

Response:

{
    "jsonrpc": "2.0",
    "result": {
        "interfaceids": [
            "30069",
            "30070"
        ]
    },
    "id": 1
}

Guarda anche

Fonte

CHostInterface::massRemove() in ui/include/classes/api/services/CHostInterface.php.