Se encuentra viendo la documentación de la versión en desarrollo, puede estar incompleta.
Esta página fue traducida automáticamente. Si detectas un error, selecciónalo y presiona Ctrl+Enter para informarlo a los editores.

host.massremove

Descripción

object host.massremove(object parameters)

Este método permite eliminar objetos relacionados de varios equipos.

Este método solo está disponible para los tipos de usuario Admin y Super admin. Los permisos para llamar al método pueden ser revocados 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 equipos a actualizar y los objetos que deben ser eliminados.

Parámetro Tipo Descripción
hostids ID/array IDs de los equipos a actualizar.

Comportamiento del parámetro:
- requerido
groupids ID/array IDs de los grupos de equipos de los que se eliminarán los equipos indicados.
interfaces object/array Interfaces de equipo a eliminar de los equipos indicados.

El objeto de interfaz de equipo debe tener definidas únicamente las propiedades ip, dns y port.
macros string/array Macros de usuario a eliminar de los equipos indicados.
templateids ID/array IDs de las plantillas a desvincular de los equipos indicados.
templateids_clear ID/array IDs de las plantillas a desvincular y limpiar de los equipos indicados.

Valores de retorno

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

Ejemplos

Desvinculación de plantillas

Desvincular una plantilla de dos equipos y eliminar todas las entidades de la plantilla.

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "host.massremove",
           "params": {
               "hostids": ["69665", "69666"],
               "templateids_clear": "325"
           },
           "id": 1
       }

Respuesta:

{
           "jsonrpc": "2.0",
           "result": {
               "hostids": [
                   "69665",
                   "69666"
               ]
           },
           "id": 1
       }

Véase también

Fuente

CHost::massRemove() en ui/include/classes/api/services/CHost.php.