Se encuentra viendo la documentación de la versión en desarrollo, puede estar incompleta.
Esta página fue traducida automáticamente. Si detectas un error, selecciónalo y presiona Ctrl+Enter para informarlo a los editores.

hostgroup.massadd

Descripción

object hostgroup.massadd(object parameters)

Este método permite añadir simultáneamente varios objetos relacionados a todos los grupos de 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

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

El método acepta los siguientes parámetros.

Parámetro Tipo Descripción
groups object/array Grupos de equipos a actualizar.

Los grupos de equipos deben tener definida únicamente la propiedad groupid.

Comportamiento del parámetro:
- obligatorio
hosts object/array Equipos a añadir a todos los grupos de equipos.

Los equipos deben tener definida únicamente la propiedad hostid.

Valores de retorno

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

Ejemplos

Añadir equipos a grupos de equipos

Añadir dos equipos a los grupos de equipos con IDs 5 y 6.

Petición:

{
           "jsonrpc": "2.0",
           "method": "hostgroup.massadd",
           "params": {
               "groups": [
                   {
                       "groupid": "5"
                   },
                   {
                       "groupid": "6"
                   }
               ],
               "hosts": [
                   {
                       "hostid": "30050"
                   },
                   {
                       "hostid": "30001"
                   }
               ]
           },
           "id": 1
       }

Respuesta:

{
           "jsonrpc": "2.0",
           "result": {
               "groupids": [
                   "5",
                   "6"
               ]
           },
           "id": 1
       }

Véase también

Fuente

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