[comment]: # ({d2516189-d2516189})
# graph.update

[comment]: # ({/d2516189-d2516189})

[comment]: # ({992bc0de-992bc0de})
### 描述

`object graph.update(object/array graphs)`

此方法允许update现有图表。

::: noteclassic
此方法仅适用于*管理员*和*超级管理员*
用户类型。调用该方法的权限可在用户角色
设置中撤销。更多信息请参阅[User
roles](/manual/web_interface/frontend_sections/administration/user_roles)。

:::

[comment]: # ({/992bc0de-992bc0de})

[comment]: # ({c695fc44-72c99624})
### 参数

`(object/array)` 需要更新的图表属性。

每个图表必须定义 `graphid` 属性，其他属性均为可选。仅传递的属性会被更新，其余属性将保持不变。

除了 [图表](object#图表) 之外，该方法还接受以下参数。

| 参数 | [数据类型](/manual/api/reference_commentary#数据类型) | 描述 |
|--|--|------|
| gitems | array | 用于替换现有图表 监控项 的图表 [items](/manual/api/reference/graphitem/object)。如果图表 监控项 已定义 `gitemid` 属性，则会被更新，否则将创建新的图表 监控项。 |

[comment]: # ({/c695fc44-72c99624})

[comment]: # ({9a0b4500-9a0b4500})
### 返回值

`(object)` 返回一个包含更新图表ID的object，存储在`graphids`属性下。

[comment]: # ({/9a0b4500-9a0b4500})

[comment]: # ({b41637d2-b41637d2})
### 示例

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({c0e2f168-7b33f5ce})
#### 设置 Y 轴刻度最大值

将Y轴最大刻度固定设置为100.

请求:

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

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

[comment]: # ({/c0e2f168-7b33f5ce})

[comment]: # ({84b1446b-84b1446b})
### 来源

CGraph::update() 位于 *ui/include/classes/api/services/CGraph.php* 文件中。

[comment]: # ({/84b1446b-84b1446b})