创建

描述

object dashboard.create(object/array **dashboards**)

这个方法允许创建新的仪表板。

参数

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

另外，对于标准仪表板属性，该方法还接受以下参数。

参数类型描述
widgets数组将为仪表板创建的仪表板小组件。
users数组将在仪表板上创建的仪表板用户共享。
userGroups数组将在仪表板上创建的仪表板用户组共享。

返回值

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

示例

创建一个仪表板

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

请求：

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

响应：

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

参见

来源

CDashboard::create() in frontends/php/include/classes/api/services/CDashboard.php.