Zabbix Documentation 4.0

3.04.04.24.4 (current)| In development:5.0 (devel)| Unsupported:1.82.02.22.43.23.4Guidelines

User Tools

Site Tools


Sidebar

zh:manual:api:reference:graph:update

graph.update

Description

描述

object graph.update(object/array graphs) 对象 graph.update(object/array graphs)

This method allows to update existing graphs. 此方法用于更新已存在的图表。

Parameters

参数

(object/array) Graph properties to be updated. (对象/数组) 要更新的图表属性.

The graphid property must be defined for each graph, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. 每一个图表都必须定义graphid 属性, 其它属性均为可选项. 只有被传递的属性会被更新, 其他属性将保持不变.

Additionally to the standard graph properties the method accepts the following parameters. 除了 标准图表属性 之外,此方法还接受以下参数.

Parameter Type Description
gitems array Graph items to replace existing graph items. If a graph item has the gitemid property defined it will be updated, otherwise a new graph item will be created.
参数 类型 描述
gitems array 替换已存在图表监控项的图表监控项. 如果一个图表监控项的 gitemid 属性已经被定义,那么它将会被更新, 否则将会创建一个新的图表监控项.

Return values

返回值

(object) Returns an object containing the IDs of the updated graphs under the graphids property. (对象)graphids 属性下,返回一个包含已更新图表的ID的对象。

Examples

例子

Setting the maximum for the Y scale

设置Y刻度的最大值

Set the the maximum of the Y scale to a fixed value of 100. 设置Y刻度的最大值为固定值100.

Request: 请求:

{
    "jsonrpc": "2.0",
    "method": "graph.update",
    "params": {
        "graphid": "439",
        "ymax_type": 1,
        "yaxismax": 100
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}

Response: 响应:

{
    "jsonrpc": "2.0",
    "result": {
        "graphids": [
            "439"
        ]
    },
    "id": 1
}

Source

来源

CGraph::update() in frontends/php/include/classes/api/services/CGraph.php.