host.massadd
Descripción
object host.massadd(object parameters)
Este método permite agregar simultáneamente múltiples objetos relacionados a todos los hosts dados.
Este método solo está disponible para tipos de usuatrios 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
(object) Parámetros que contienen los ID de los hosts a actualizar y el
objetos para agregar a todos los hosts.
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 | Grupos de hosts para agregar a los hosts dados. Los grupos de hosts deben tener la propiedad groupid definida. |
| interfaces | objeto/matriz | Host interfaces que se crearán para los hosts dados. |
| macros | objeto/matriz | User macros que se crearán para los hosts dados. |
| templates | objeto/matriz | Templates para vincular a los hosts dados. Las templates deben tener definida la propiedad templateid. |
Valores devueltos
(object) Devuelve un objeto que contiene los IDs de los hosts actualizados
bajo la propiedad hostids.
Ejemplos
Agregar macros
Agregue dos nuevas macros a dos hosts.
Solicitud:
{
"jsonrpc": "2.0",
"method": "host.massadd",
"params": {
"hosts": [
{
"hostid": "10160"
},
{
"hostid": "10167"
}
],
"macros": [
{
"macro": "{$TEST1}",
"value": "MACROTEST1"
},
{
"macro": "{$TEST2}",
"value": "MACROTEST2",
"description": "Test description"
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Respuesta:
{
"jsonrpc": "2.0",
"result": {
"hostids": [
"10160",
"10167"
]
},
"id": 1
}Ver también
-host.update -Host group -Template -User macro -Host interface
Fuente
CHost::massAdd() en ui/include/classes/api/services/CHost.php.