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

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

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

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

此方法允许update现有的图形原型。

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

:::

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

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

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

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

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

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

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

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

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

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

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

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

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

将图形原型尺寸修改为1100×400像素

请求:

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

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

[comment]: # ({/0d546677-c044eff0})

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

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

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