dashboard.update

説明

object dashboard.update(object/array dashboards)

このメソッドは、既存のダッシュボードを更新することができます。

パラメータ

(object/array) 更新するダッシュボードのプロパティ。

各ダッシュボードでは dashboardid プロパティを定義する必要があり、その他の プロパティはすべて任意です。渡されたプロパティのみが 更新され、その他はすべて変更されません。

このメソッドは、標準のダッシュボードプロパティ に加えて、以下のパラメータを受け付けます。

戻り値

(object) dashboardidsプロパティの下にある更新されたダッシュボードのIDを含むオブジェクトを返します。

例

ダッシュボードの名前変更

ダッシュボードの名前を"SQL server status"に変更します。

リクエスト:

{
    "jsonrpc": "2.0",
    "method": "dashboard.update",
    "params": {
        "dashboardid": "2",
        "name": "SQL server status"
    },
    "id": 1
}

レスポンス:

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

ダッシュボードページの更新

最初のダッシュボードページの名前を変更し、2番目のダッシュボードページのウィジェットを置き換えて、3番目のページとして新しいページを追加します。他のすべてのダッシュボードページを削除します。

リクエスト:

{
    "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": 12,
                        "height": 3
                    }
                ]
            },
            {
                "display_period": 60
            }
        ]
    },
    "id": 1
}

レスポンス:

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

ダッシュボードの所有者の変更

Adminとsuper adminのみが使用できます。

リクエスト:

{
    "jsonrpc": "2.0",
    "method": "dashboard.update",
    "params": {
        "dashboardid": "2",
        "userid": "1"
    },
    "id": 1
}

レスポンス:

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

関連項目

• ダッシュボードページ
• ダッシュボードウィジェット
• ダッシュボードウィジェットフィールド
• ダッシュボードユーザー
• ダッシュボードユーザーグループ

ソース

CDashboard::update() in ui/include/classes/api/services/CDashboard.php.