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.massupdate

Descripción

object hostgroup.massupdate(object parameters)

Este método permite reemplazar equipos y plantillas por los especificados en varios grupos de equipos.

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 obtener más información.

Parámetros

(objeto) Parámetros que contienen los IDs de los grupos de equipos a actualizar y los objetos que deben ser actualizados.

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

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

Comportamiento del parámetro:
- obligatorio
hosts objeto/array Equipos para reemplazar los equipos actuales en los grupos de equipos indicados.
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 únicamente la propiedad hostid.

Comportamiento del parámetro:
- obligatorio

Valores de retorno

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

Ejemplos

Reemplazar equipos en un grupo de equipos

Reemplace todos los equipos en 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
       }

Véase también

Fuente

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