module.get

Beschreibung

integer/array module.get(object parameters)

Die Methode ermöglicht es Ihnen, Module anhand der angegebenen Parameter abzurufen.

Diese Methode ist nur für den Benutzertyp Super admin verfügbar. Berechtigungen zum Aufruf der Methode können in den Benutzerrolleneinstellungen widerrufen werden. Weitere Informationen finden Sie unter Benutzerrollen.
Wenn $ZBX_FEATURE_FLAGS['modules_config_enabled'] in der Frontend-Konfigurationsdatei (zabbix.conf.php) auf false gesetzt ist, darf der Benutzer diese Methode nicht aufrufen.

Parameter

(object) Parameter, die die gewünschte Ausgabe definieren.

Die Methode unterstützt die folgenden Parameter.

Parameter Typ Beschreibung
moduleids ID/array Gibt nur Module mit den angegebenen IDs zurück.
sortfield string/array Sortiert das Ergebnis nach den angegebenen Eigenschaften.

Mögliche Werte: moduleid, relative_path.
countOutput boolean Diese Parameter werden im Referenzkommentar beschrieben.
excludeSearch boolean
filter object
limit integer
output query
preservekeys boolean
search object
searchByAny boolean
searchWildcardsEnabled boolean
sortorder string/array
startSearch boolean

Rückgabewerte

(integer/array) Gibt entweder:

  • eine Reihe von Objekten zurück;
  • die Anzahl der abgerufenen Objekte, wenn der Parameter countOutput verwendet wurde zurück.

Beispiele

Abrufen eines Moduls anhand der ID

Rufen Sie alle Daten zu den Modulen „1“, „2“ und „25“ ab.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "module.get",
    "params": {
        "output": "extend",
        "moduleids": [
            "1",
            "2",
            "25"
        ]
    },
    "id": 1
}

Antwort:

{
    "jsonrpc": "2.0",
    "result": [
        {
            "moduleid": "1",
            "id": "actionlog",
            "relative_path": "widgets/actionlog",
            "status": "1",
            "config": []
        },
        {
            "moduleid": "2",
            "id": "clock",
            "relative_path": "widgets/clock",
            "status": "1",
            "config": []
        },
        {
            "moduleid": "25",
            "id": "example",
            "relative_path": "modules/example_module",
            "status": "1",
            "config": []
        }
    ],
    "id": 1
}

Siehe auch

Quelle

CModule::get() in ui/include/classes/api/services/CModule.php.