host.massremove

Descripció

object host.massremove(object parameters)

Aquest mètode esborrar els objectes associats a diversos equips.

Tenim aquest mètode disponible només per als usuaris Admin i Super admin. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu Rols d'usuari.

Paràmetres

(object) Paràmetres que contenen els identificadors d'equips a actualitzar i objectes a esborrar.

Paràmetre	Tipus	Descripció
hostids (obligatori)	string/array	ID dels equips a actualitzar.
groupids	string/array	Grups d'equips dels quals esborrar els equips donats.
interfícies	objecte/array	Interfícies de l'equip que s'han d'esborrar dels equips donats. L'objecte de la interfície de l'equip ha de tindre les propietats `ip`, `dns` i `port` configurades.
macros	string/array	Macros d'usuari per esborrar dels equips donats.
templateids	string/array	Plantilles per desenllaçar dels equips donats.
templateids_clear	string/array	Plantilles per desenllaçar i esborrar els equips donats.

Valors de retorn

(object) Retorna un objecte contingut als IDs dels equips actualitzats sota la propietat hostids.

Exemples

Desenllaçar plantilles

Desenllaçar una plantilla de dos equips i esborrar totes les entitats basades en aquesta plantilla.

Petició:

{
           "jsonrpc": "2.0",
           "method": "host.massremove",
           "params": {
               "hostids": ["69665", "69666"],
               "templateids_clear": "325"
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Resposta:

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

Veieu també

Font

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

Documentation