hostgroup.massupdate

Descripción

object hostgroup.massupdate(object parameters)

Este método permite reemplazar equipos y plantillas con las especificadas en varios grupos de equipos.

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 que deben actualizarse.

Parámetro Tipo Descripción
groups objeto/matriz Grupos de equipos que se actualizarán.

Los grupos de equipos deben tener solamente la propiedad groupid definida.

Comportamiento del parámetro:
- obligatorio
hosts objeto/matriz Equipos para reemplazar los equipos actuales en los grupos de equipos dados.
Todos los demás equipos, excepto los mencionados, serán excluidos de los grupos de equipos.
Los equipos descubiertos no se verán afectados.

Los equipos deben tener definida la propiedad hostid.

Comportamiento del parámetro:
- requerido

Valores de retorno

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

Ejemplos

Reemplazo de equipos en un grupo de equipos

Reemplace todos los equipos de un grupo de equipos por los equipos mencionados.

Solicitud:

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

Respuesta:

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

Ver también

Fuente

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