Se encuentra viendo la documentación de la versión en desarrollo, puede estar incompleta.
Únase a nuestro proyecto de traducción y ayude a traducir la documentación de Zabbix a su lengua materna.

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.