[comment]: # ({259f747f-259f747f})
# hostgroup.update

[comment]: # ({/259f747f-259f747f})

[comment]: # ({44386689-32bf01b5})
### Descripción

`object hostgroup.update(object/array hostGroups)`

Este método permite actualizar los grupos de equipos existentes.

::: noteclassic
Este método solo está disponible para los tipos de usuarios *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](/manual/web_interface/frontend_sections/users/user_roles)
para más información.
:::

[comment]: # ({/44386689-32bf01b5})

[comment]: # ({46c922cb-9c20e34d})
### Parámetros

`(object/array)` [Propiedades del grupo de hosts](object#host-group) que se actualizarán.

La propiedad `groupid` debe definirse para cada grupo de hosts, todas las demás propiedades son opcionales. Sólo se actualizarán las propiedades indicadas, todas las demás permanecerán sin cambios.

[comment]: # ({/46c922cb-9c20e34d})

[comment]: # ({736f3b05-736f3b05})
### Valores devueltos



`(object)` Devuelve un objeto que contiene los ID del host propagado

grupos bajo la propiedad `groupids`.

[comment]: # ({/736f3b05-736f3b05})

[comment]: # ({b41637d2-b41637d2})
### Ejemplos

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({f2ceab2e-a296ad88})
#### Cambiar el nombre de un grupo de equipos

Cambiar el nombre de un grupo de equipos a "hosts Linux".

[Solicitud](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "hostgroup.update",
    "params": {
        "groupid": "7",
        "name": "Linux hosts"
    },
    "id": 1
}
```

Respuesta:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "groupids": [
            "7"
        ]
    },
    "id": 1
}
```

[comment]: # ({/f2ceab2e-a296ad88})

[comment]: # ({b75d89b4-b75d89b4})
### Fuente



CHostGroup::update() en

*ui/include/classes/api/services/CHostGroup.php*.

[comment]: # ({/b75d89b4-b75d89b4})