hostgroup.massadd

Descripción

object hostgroup.massadd(object parameters)

Este método le permite agregar simultáneamente múltiples objetos relacionados a todos los grupos de hosts especificados.

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 roles de usuario. Consulte Roles de usuario para obtener más información.

Parámetros

(object) Parámetros que contienen los IDs de los grupos de host a actualizar y los objetos a añadir a todos los grupos de host.

El método acepta los siguientes parámetros.

Parámetro Tipo Descripción
groups object/array Grupos de host a actualizar.

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

Comportamiento del parámetro:
- obligatorio
hosts object/array Hosts a añadir a todos los grupos de host.

Los hosts deben tener definida únicamente la propiedad hostid.

Valores de retorno

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

Ejemplos

Añadir equipos a grupos de equipos

Añadir dos equipos a los grupos de equipos con IDs 5 y 6.

Petición:

{
    "jsonrpc": "2.0",
    "method": "hostgroup.massadd",
    "params": {
        "groups": [
            {
                "groupid": "5"
            },
            {
                "groupid": "6"
            }
        ],
        "hosts": [
            {
                "hostid": "30050"
            },
            {
                "hostid": "30001"
            }
        ]
    },
    "id": 1
}

Respuesta:

{
    "jsonrpc": "2.0",
    "result": {
        "groupids": [
            "5",
            "6"
        ]
    },
    "id": 1
}

Véase también

Fuente

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