module.get
Descripción
integer/array module.get(object parameters)
El método permite recuperar módulos según los parámetros proporcionados.
Este método solo está disponible para el tipo de usuario Super admin.
Los permisos para llamar al método pueden revocarse en la configuración del rol de usuario.
Consulte User roles para obtener más información.
Si $ZBX_FEATURE_FLAGS['modules_config_enabled'] está establecido en false en el frontend configuration file (zabbix.conf.php), no se permitirá al usuario llamar a este método.
Parámetros
(object) Parámetros que definen la salida deseada.
El método admite los siguientes parámetros.
| Parámetro | Tipo | Descripción |
|---|---|---|
| moduleids | ID/array | Devolver solo los módulos con los IDs dados. |
| sortfield | string/array | Ordenar el resultado por las propiedades dadas. Valores posibles: moduleid, relative_path. |
| countOutput | boolean | Estos parámetros se describen en el Comentario de referencia. |
| excludeSearch | boolean | |
| filter | object | |
| limit | integer | |
| output | query | |
| preservekeys | boolean | |
| search | object | |
| searchByAny | boolean | |
| searchWildcardsEnabled | boolean | |
| sortorder | string/array | |
| startSearch | boolean |
Valores de retorno
(integer/array) Devuelve:
- un array de objetos;
- el número de objetos recuperados, si se ha utilizado el parámetro
countOutput.
Ejemplos
Recuperar un módulo por ID
Recuperar todos los datos sobre los módulos "1", "2" y "25".
{
"jsonrpc": "2.0",
"method": "module.get",
"params": {
"output": "extend",
"moduleids": [
"1",
"2",
"25"
]
},
"id": 1
}
Respuesta:
{
"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
}
Véase también
Origen
CModule::get() en ui/include/classes/api/services/CModule.php.