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.

Documentation