[comment]: # ({66fb9690-66fb9690})
# dashboard.update

[comment]: # ({/66fb9690-66fb9690})

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

`object dashboard.update(object/array dashboards)`

此方法允许update现有仪表板.

::: noteclassic
该方法适用于所有类型的用户. 调用该方法的权限可以在用户角色设置中撤销. 更多信息请参阅[User
roles](/manual/web_interface/frontend_sections/administration/user_roles).

:::

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

[comment]: # ({e326f7c3-62947aa0})
### 参数

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

每个仪表板必须指定 `dashboardid` 属性，其他所有属性均为可选。仅指定的属性会被更新。

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

| 参数 | [数据类型](/manual/api/reference_commentary#数据类型) | 描述 |
|--|--|------|
| pages | array | 用于替换现有仪表板页面的仪表板 [仪表板页面](object#仪表板页面)。<br><br>仪表板页面通过 `dashboard_pageid` 属性更新。对于没有 `dashboard_pageid` 属性的 objects 将创建新的仪表板页面，未重用的现有仪表板页面将被删除。仪表板页面将按照指定的顺序排序。仅仪表板页面的指定属性会被更新。`pages` 属性至少需要一个仪表板页面 object。 |
| users | array | 用于替换现有元素的仪表板 [仪表盘用户](object#仪表盘用户) 共享。 |
| userGroups | array | 用于替换现有元素的仪表板 [dashboard-用户组](object#dashboard-用户组) 共享。 |

[comment]: # ({/e326f7c3-62947aa0})

[comment]: # ({28e89b38-28e89b38})
### 返回值

`(object)` 返回一个包含更新仪表板ID的object，这些ID位于`dashboardids`属性下。

[comment]: # ({/28e89b38-28e89b38})

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

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

[comment]: # ({c1d3fbad-7fcf7de4})
#### 重命名仪表板

将仪表板重命名为"SQL服务器状态".

请求:

```json
{
    "jsonrpc": "2.0",
    "method": "dashboard.update",
    "params": {
        "dashboardid": "2",
        "name": "SQL server status"
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```
响应:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "dashboardids": [
            "2"
        ]
    },
    "id": 1
}
```

[comment]: # ({/c1d3fbad-7fcf7de4})

[comment]: # ({891d2164-b8348b8a})
#### 更新仪表板页面

重命名第一个仪表板页面，替换第二个仪表板页面上的部件，
并添加一个新页面作为第三个页面。删除所有其他仪表板页面。

请求:

```json
{
    "jsonrpc": "2.0",
    "method": "dashboard.update",
    "params": {
        "dashboardid": "2",
        "pages": [
            {
                "dashboard_pageid": 1,
                "name": 'Renamed Page'
            },
            {
                "dashboard_pageid": 2,
                "widgets": [
                    {
                        "type": "clock",
                        "x": 0,
                        "y": 0,
                        "width": 4,
                        "height": 3
                    }
                ]
            },
            {
                "display_period": 60
            }
        ]
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```
响应:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "dashboardids": [
            "2"
        ]
    },
    "id": 2
}
```

[comment]: # ({/891d2164-b8348b8a})

[comment]: # ({d82abd77-e4a57dd3})
#### 更改仪表盘所有者

仅限管理员和超级管理员使用。

请求:

```json
{
    "jsonrpc": "2.0",
    "method": "dashboard.update",
    "params": {
        "dashboardid": "2",
        "userid": "1"
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 2
}
```
响应:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "dashboardids": [
            "2"
        ]
    },
    "id": 2
}
```

[comment]: # ({/d82abd77-e4a57dd3})

[comment]: # ({299ae089-299ae089})
### 另请参阅

-   [仪表板页面](object#仪表板页面)
-   [仪表板小部件](object#仪表板小部件)
-   [仪表板小部件字段](object#仪表板小部件字段)
-   [仪表盘用户](object#仪表盘用户)
-   [dashboard-用户组](object#dashboard-用户组)

[comment]: # ({/299ae089-299ae089})

[comment]: # ({456ac32b-456ac32b})
### 来源

CDashboard::update() 位于
*ui/include/classes/api/services/CDashboard.php*。

[comment]: # ({/456ac32b-456ac32b})