host.massadd

Descripción

object host.massadd(object parameters)

Este método permite agregar simultáneamente múltiples objetos relacionados a todos los hosts dados.

Este método solo está disponible para tipos de usuatrios Administrador y Superadministrador. Los permisos para activar el método se pueden revocar en ajustes de rol de usuario. Ver User roles para más información.

Parámetros

(object) Parámetros que contienen los ID de los hosts a actualizar y el objetos para agregar a todos los hosts.

El método acepta los siguientes parámetros.

Parámetro	Tipo	Descripción
hosts (obligatorio)	objeto/matriz	Hosts a actualizar. Los hosts deben tener la propiedad `hostid` definida.
grupos	objeto/matriz	Grupos de hosts para agregar a los hosts dados. Los grupos de hosts deben tener la propiedad `groupid` definida.
interfaces	objeto/matriz	Host interfaces que se crearán para los hosts dados.
macros	objeto/matriz	User macros que se crearán para los hosts dados.
templates	objeto/matriz	Templates para vincular a los hosts dados. Las templates deben tener definida la propiedad `templateid`.

Valores devueltos

(object) Devuelve un objeto que contiene los IDs de los hosts actualizados bajo la propiedad hostids.

Ejemplos

Agregar macros

Agregue dos nuevas macros a dos hosts.

Solicitud:

{
       "jsonrpc": "2.0",
       "method": "host.massadd",
       "params": {
       "hosts": [
       {
       "hostid": "10160"
       },
       {
       "hostid": "10167"
       }
       ],
       "macros": [
       {
       "macro": "{$TEST1}",
       "value": "MACROTEST1"
       },
       {
       "macro": "{$TEST2}",
       "value": "MACROTEST2",
       "description": "Test description"
       }
       ]
       },
       "auth": "038e1d7b1735c6a5436ee9eae095879e",
       "id": 1
       }

Respuesta:

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

Ver también

-host.update -Host group -Template -User macro -Host interface

Fuente

CHost::massAdd() en ui/include/classes/api/services/CHost.php.

Documentation