hostgroup.massadd

Descripción

object hostgroup.massadd(object parameters)

Este método permite agregar simultáneamente múltiples objetos relacionados a todos los grupos de equipos dados.

Este método solo está disponible para los tipos de usuario 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 para más información.

Parámetros

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

El método acepta los siguientes parámetros.

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

Los grupos de hosts deben tener definida sólo la propiedad groupid.

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

Los hosts deben tener definida sólo la propiedad hostid.

Valores de retorno

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

Ejemplos

Agregar equipos a grupos de equipos

Agregue dos equipos a los grupos de equipos con ID 5 y 6.

Solicitud:

{
    "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
}

Ver también

Fuente

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