host.massadd

Descripción

object host.massadd(object parameters)

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

Este método solo está disponible para los tipos de usuarios Administrador y Superadministrador. Los permisos para llamar al método se pueden revocar en la configuración del rol de usuario. Ver Roles de usuario para más información.

Parámetros

(objeto) Parámetros que contienen los ID de los equipos a actualizar y los objetos para agregar a todos los equipos.

El método acepta los siguientes parámetros.

Parámetro	Tipo	Descripción
hosts	objeto/matriz	Equipos que se actualizarán. Los equipos deben tener definida la propiedad `hostid`. Comportamiento de parámetros: - obligatorio
groups	objeto/matriz	Grupos de equipos para agregar a los equipos dados. Los grupos de equipos deben tener la propiedad `groupid` definida.
interfaces	objeto/matriz	Interfaces de host que se crearán para los equipos dados.
macros	objeto/matriz	Macros de usuario que se crearán para los equipos dados.
templates	objeto/matriz	Plantillas para vincular a los equipos dados. Las plantillas deben tener definida la propiedad `templateid`.

Valores devueltos

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

Ejemplos

Agregar macros

Agregue dos nuevas macros a dos equipos.

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"
                   }
               ]
           },
           "id": 1
       }

Respuesta:

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

Ver también

Fuente

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

Documentation