hostgroup.massupdate

Descripción

object hostgroup.massupdate(object parameters)

Este método permite reemplazar hosts y templates por los especificados en varios grupos de hosts.

Este método solo está disponible para los tipos de usuario Admin y Super admin. Los permisos para llamar al método pueden revocarse en la configuración de los roles de usuario. Consulte Roles de usuario para obtener 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.