template.massupdate

Descripción

object template.massupdate(object parameters)

Este método permite reemplazar o eliminar simultáneamente objetos relacionados. y actualizar propiedades en múltiples plantillas.

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 obtener más información.

Parámetros

(object) Parámetros que contienen los IDs de las templates a actualizar y los objetos a reemplazar para las templates.

El método acepta los siguientes parámetros.

Parámetro Tipo Descripción
templates object/array Templates que se actualizarán.

Las templates deben tener definida únicamente la propiedad templateid.

Comportamiento del parámetro:
- obligatorio
groups object/array Grupos de templates para reemplazar los grupos de templates actuales a los que pertenecen las templates.

Los grupos de templates deben tener definida únicamente la propiedad groupid.
macros object/array Macros de usuario para reemplazar todas las macros de usuario actuales en las templates indicadas.
templates_clear object/array Templates para desvincular y limpiar de las templates indicadas.

Las templates deben tener definida únicamente la propiedad templateid.
templates_link object/array Templates para reemplazar las templates actualmente vinculadas.

Las templates deben tener definida únicamente la propiedad templateid.

Valores de retorno

(objeto) Devuelve un objeto que contiene los ID de las plantillas actualizadas bajo la propiedad templateids.

Ejemplos

Desvincular una plantilla

Desvincule y borre la plantilla "10091" de las plantillas proporcionadas.

Solicitud:

{
    "jsonrpc": "2.0",
    "method": "template.massupdate",
    "params": {
        "templates": [
            {
                "templateid": "10085"
            },
            {
                "templateid": "10086"
            }
        ],
        "templates_clear": [
            {
                "templateid": "10091"
            }
        ]
    },
    "id": 1
}

Respuesta:

{
    "jsonrpc": "2.0",
    "result": {
        "templateids": [
            "10085",
            "10086"
        ]
    },
    "id": 1
}

Reemplazo de macros de usuario

Reemplace todas las macros de usuario con la macro de usuario proporcionada en varias plantillas.

Solicitud:

{
    "jsonrpc": "2.0",
    "method": "template.massupdate",
    "params": {
        "templates": [
            {
                "templateid": "10074"
            },
            {
                "templateid": "10075"
            },
            {
                "templateid": "10076"
            },
            {
                "templateid": "10077"
            }
        ],
        "macros": [
            {
                "macro": "{$AGENT.TIMEOUT}",
                "value": "5m",
                "description": "Timeout after which agent is considered unavailable. Works only for agents reachable from Zabbix server/proxy (passive mode)."
            }
        ]
    },
    "id": 1
}

Respuesta:

{
    "jsonrpc": "2.0",
    "result": {
        "templateids": [
            "10074",
            "10075",
            "10076",
            "10077"
        ]
    },
    "id": 1
}

Ver también

Fuente

CTemplate::massUpdate() en ui/include/classes/api/services/CTemplate.php.