创建

描述

object dashboard.create(object/array dashboards)

此方法允许创建新的仪表盘。

此方法对于任何用户可用。可以在用户角色设置中撤销调用该方法的权限。更多信息请查看 用户角色。

参数

(object/array) 要创建的仪表盘。

除了标准仪表盘属性，此方法还接受以下参数：

参数类型说明
pages
（必需）		array仪表盘上创建的仪表盘页面 。仪表盘页面的顺序将与指定的顺序相同。pages属性至少需要一个仪表盘页面对象。
usersarray仪表盘上创建的仪表盘用户 。
userGroupsarray仪表盘上创建的仪表盘用户组 。

返回值

(object) 返回一个对象，该对象包含 dashboardids 属性下创建的仪表盘的 ID。返回的 ID 的顺序与所传递的仪表盘的顺序相匹配。

示例

创建仪表盘

创建一个名为 “My dashboard” 的仪表盘，其中有一个带有标签的问题部件，并使用了两种类型的共享（用户组和用户）。

请求：

  1. {
  2.            "jsonrpc": "2.0",
  3.            "method": "dashboard.create",
  4.            "params": {
  5.                "name": "My dashboard",
  6.                "display_period": 30,
  7.                "auto_start": 1,
  8.                "pages": [
  9.                    {
  10.                        "widgets": [
  11.                            {
  12.                                "type": "problems",
  13.                                "x": 0,
  14.                                "y": 0,
  15.                                "width": 12,
  16.                                "height": 5,
  17.                                "view_mode": 0,
  18.                                "fields": [
  19.                                    {
  20.                                        "type": 1,
  21.                                        "name": "tags.tag.0",
  22.                                        "value": "service"
  23.                                    },
  24.                                    {
  25.                                        "type": 0,
  26.                                        "name": "tags.operator.0",
  27.                                        "value": 1
  28.                                    },
  29.                                    {
  30.                                        "type": 1,
  31.                                        "name": "tags.value.0",
  32.                                        "value": "zabbix_server"
  33.                                    }
  34.                                ]
  35.                            }
  36.                        ]
  37.                    }
  38.                ],
  39.                "userGroups": [
  40.                    {
  41.                        "usrgrpid": "7",
  42.                        "permission": 2
  43.                    }
  44.                ],
  45.                "users": [
  46.                    {
  47.                        "userid": "4",
  48.                        "permission": 3
  49.                    }
  50.                ]
  51.            },
  52.            "auth": "038e1d7b1735c6a5436ee9eae095879e",
  53.            "id": 1
  54.        }

响应：

  1. {
  2.            "jsonrpc": "2.0",
  3.            "result": {
  4.                "dashboardids": [
  5.                    "2"
  6.                ]
  7.            },
  8.            "id": 1
  9.        }

参阅

来源

ui/include/classes/api/services/CDashboard.php 中的 CDashboard::create()。