host.massadd

Descripción

object host.massadd(object parameters)

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

Este método solo está disponible para los tipos de usuario Admin y Super admin. Los permisos para llamar al método pueden ser revocados en la configuración de roles de usuario. Consulte Roles de usuario para más información.

Parámetros

(objeto) Parámetros que contienen los IDs de los equipos a actualizar y los objetos a añadir a todos los equipos.

El método acepta los siguientes parámetros.

Parámetro	Tipo	Descripción
hosts	objeto/array	Equipos a actualizar. Los equipos deben tener definida únicamente la propiedad `hostid`. Comportamiento del parámetro: - requerido
groups	objeto/array	Grupos de equipos a añadir a los equipos indicados. Los grupos de equipos deben tener definida únicamente la propiedad `groupid`.
interfaces	objeto/array	Interfaces de equipo a crear para los equipos indicados.
macros	objeto/array	Macros de usuario a crear para los equipos indicados.
templates	objeto/array	Plantillas a enlazar a los equipos indicados. Las plantillas deben tener definida únicamente la propiedad `templateid`.

Valores de retorno

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

Ejemplos

Añadir macros

Añadir 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": "Descripción de prueba"
                   }
               ]
           },
           "id": 1
       }

Respuesta:

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

Véase también

Fuente

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

Documentation