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

(objeto) Parámetros que contienen los ID de los grupos de equipos a actualizar y los objetos a agregar a todos los grupos de equipos.

El método acepta los siguientes parámetros.

Parámetro Tipo Descripción
groups objeto/matriz Grupos de equipos que se actualizarán.

Los grupos de hosts deben tener la propiedad groupid definida.

[Comportamiento del parámetro](/manual/api/reference_commentary#parameter -comportamiento):
- obligatorio
hosts objeto/matriz Equipos para agregar a todos los grupos de equipos.

Los equipos deben tener definida solamente 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.