dashboard.create

Opis

object dashboard.create(object/array dashboards)

Ta metoda umożliwia tworzenie nowych dashboardów.

Ta metoda jest dostępna dla użytkowników dowolnego typu. Uprawnienia do wywołania tej metody mogą zostać cofnięte w ustawieniach roli użytkownika. Więcej informacji można znaleźć w Rolach użytkowników.

Parametry

(object/array) Pulpity do utworzenia.

Oprócz standardowych właściwości pulpitu, metoda akceptuje następujące parametry.

Parametr Typ Opis
pages array Strony pulpitu, które mają zostać utworzone dla pulpitu. Strony pulpitu będą uporządkowane w tej samej kolejności, w jakiej zostały podane.

Zachowanie parametrów:
- wymagane
users array Udziały użytkownika pulpitu, które mają zostać utworzone na pulpicie.
userGroups array Udziały grupy użytkowników pulpitu, które mają zostać utworzone na pulpicie.

Zwracane wartości

(object) Zwraca obiekt zawierający identyfikatory utworzonych pulpitów we właściwości dashboardids. Kolejność zwróconych ID jest zgodna z kojenością przekazanych pulpitów.

Przykłady

Tworzenie pulpitu

Utwórz pulpit o nazwie „My dashboard” z jednym widżetem Problemy z tagami oraz z użyciem dwóch typów udostępniania (grupa użytkowników i użytkownik) na jednej stronie pulpitu.

Żądanie:

{
    "jsonrpc": "2.0",
    "method": "dashboard.create",
    "params": {
        "name": "My dashboard",
        "display_period": 30,
        "auto_start": 1,
        "pages": [
            {
                "widgets": [
                    {
                        "type": "problems",
                        "x": 0,
                        "y": 0,
                        "width": 36,
                        "height": 5,
                        "view_mode": 0,
                        "fields": [
                            {
                                "type": 1,
                                "name": "tags.0.tag",
                                "value": "service"
                            },
                            {
                                "type": 0,
                                "name": "tags.0.operator",
                                "value": 1
                            },
                            {
                                "type": 1,
                                "name": "tags.0.value",
                                "value": "zabbix_server"
                            }
                        ]
                    }
                ]
            }
        ],
        "userGroups": [
            {
                "usrgrpid": "7",
                "permission": 2
            }
        ],
        "users": [
            {
                "userid": "4",
                "permission": 3
            }
        ]
    },
    "id": 1
}

Odpowiedź:

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

Zobacz także

Źródło

CDashboard::create() w ui/include/classes/api/services/CDashboard.php.