host.massupdate
Descripción
object host.massupdate(object parameters)
Este método permite reemplazar o eliminar simultáneamente objetos relacionados y actualizar propiedades en múltiples hosts.
Este método solo está disponible para tipos de usuarios Administrador y Superadministrador. Los permisos para activar el método se pueden revocar en ajustes de rol de usuario. Ver User roles para más información.
Parámetros
(objecto) Parámetros que contienen los ID de los hosts a actualizar y las
propiedades que deben actualizarse.
Además de las [standard host properties, el método acepta los siguientes parámetros.
| Parámetro | Tipo | Descripción |
|---|---|---|
| hosts (obligatorio) |
objeto/matriz | Hosts a actualizar. Los hosts deben tener la propiedad hostid definida. |
| grupos | objeto/matriz | Host groupspara reemplazar los grupos de hosts actuales a los que pertenecen los hosts. Los grupos de hosts deben tener la propiedad groupid definida. |
| interfaces | objeto/matriz | Host interfaces para reemplazar las interfaces de host actuales en los hosts dados. |
| inventario | objeto | Propiedades del host inventory. El modo de inventario del host no se puede actualizar usando el parámetro inventory, use inventory_mode en su lugar. |
| macros | objeto/matriz | User macros para reemplazar las macros de usuario actuales en los hosts dados. |
| templates | objeto/matriz | Templates para reemplazar las templates actualmente vinculadas en los hosts dados. Las templates deben tener definida la propiedad templateid. |
| templates_clear | objeto/matriz | Templates para desvincular y borrar de los hosts dados. Las templates deben tener definida la propiedad templateid. |
Valores devueltos
(object) Devuelve un objeto que contiene los ID de los hosts actualizados
bajo la propiedad hostids.
Ejemplos
Habilitación de múltiples hosts
Habilite la métrica de dos hosts, es decir, establezca su estado en 0.
Solicitud:
{
"jsonrpc": "2.0",
"method": "host.massupdate",
"params": {
"hosts": [
{
"hostid": "69665"
},
{
"hostid": "69666"
}
],
"status": 0
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Respuesta:
{
"jsonrpc": "2.0",
"result": {
"hostids": [
"69665",
"69666"
]
},
"id": 1
}Ver también
Fuente
CHost::massUpdate() en ui/include/classes/api/services/CHost.php.