[comment]: # translation:outdated

[comment]: # ({a23a9b82-a23a9b82})
# graphprototype.update

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

[comment]: # ({02aaf7f4-5ac42d98})
### 描述

`object graphprototype.update(object/array graphPrototypes)`

此方法用于update现有的图形原型。

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

[comment]: # ({/02aaf7f4-5ac42d98})

[comment]: # ({06a119f5-c4171dc6})
### 参数

`(object/array)` 要更新的图形原型属性。

每个图形原型必须定义 `graphid` 属性，
其他所有属性都是可选的。仅会更新传递的属性，其余属性将保持不变。

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

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

[comment]: # ({/06a119f5-c4171dc6})

[comment]: # ({8d626778-8d626778})
### 返回值

`(object)` 返回一个 object，其中包含更新后的图形原型的 ID，这些 ID 位于 `graphids` 属性下。

[comment]: # ({/8d626778-8d626778})

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

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

[comment]: # ({5121447c-c044eff0})
#### 修改图形原型大小

将图形原型的大小更改为 1100 至 400 像素。

[执行请求](/manual/api#执行请求):


```json
{
    "jsonrpc": "2.0",
    "method": "graphprototype.update",
    "params": {
        "graphid": "439",
        "width": 1100,
        "height": 400
    },
    "id": 1
}
```
响应：


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

[comment]: # ({/5121447c-c044eff0})

[comment]: # ({743007eb-743007eb})
### 来源

CGraphPrototype::update() 在
*ui/include/classes/api/services/CGraphPrototype.php* 中。

[comment]: # ({/743007eb-743007eb})