Esta es una traducción de la página de documentación original en español. Ayúdanos a mejorarla.

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 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 objeto/matriz Hosts a actualizar.

Los equipos deben tener solo la propiedad hostid definida.

Comportamiento de parámetros:
- obligatorio
groups objeto/matriz Grupos de equipos para agregar a los equipos dados.

Los grupos de equipos deben tener solo la propiedad groupid definida.
interfaces objeto/matriz Interfaces de equipo 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 solo la propiedad templateid definida.

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
       }
Copy
✔ Copied

Respuesta:

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

Ver también

Fuente

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

To toggle search highlight, press Ctrl+Alt+H
Have an improvement suggestion for this page? Select the text that could be improved and press Ctrl+Enter to send it to the editors.