hostgroup.massadd

Descripción

object hostgroup.massadd(object parameters)

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

Este método solo está disponible para los tipos de usuario 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 grupos de equipos a actualizar y los objetos a agregar a todos los grupos de equipos.

El método acepta los siguientes parámetros.

Parámetro	Tipo	Descripción
groups	objeto/matriz	Grupos de equipos que se actualizarán. Los grupos de hosts deben tener la propiedad `groupid` definida. Comportamiento del parámetro: - obligatorio
hosts	objeto/matriz	Equipos para agregar a todos los grupos de equipos. Los equipos deben tener definida solamente la propiedad `hostid`.

Valores de retorno

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

Ejemplos

Agregar equipos a grupos de equipos

Agregue dos equipos a los grupos de equipos con ID 5 y 6.

Solicitud:

{
           "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
       }

Ver también

Host

Fuente

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

Documentation