Database modules config requests
Configure Redis module requests
Method |
Path |
Description |
POST |
/v1/bdbs/{uid}/modules/config |
Configure module |
Configure module
POST /v1/bdbs/{string: uid}/modules/config
Use the module runtime configuration command (if defined) to configure new arguments for the module.
Required permissions
Request
Example HTTP request
POST /bdbs/1/modules/config
Example JSON body
{
"modules": [
{
"module_name": "search",
"module_args": "MINPREFIX 3 MAXEXPANSIONS 1000"
}
]
}
Key |
Value |
Description |
Host |
cnm.cluster.fqdn |
Domain name |
Accept |
application/json |
Accepted media type |
Request body
Field |
Type |
Description |
modules |
list of JSON objects |
List of modules (module_name) and their new configuration settings (module_args) |
module_name |
search
ReJSON
graph
timeseries
bf |
Module's name |
module_args |
string |
Module command line arguments (pattern does not allow special characters &,<,>,”) |
Response
Returns a status code. If an error occurs, the response body may include an error code and message with more details.
Error codes
When errors are reported, the server may return a JSON object with error_code
and message
field that provide additional information. The following are possible error_code
values:
Code |
Description |
db_not_exist |
Database with given UID doesn't exist in cluster |
missing_field |
"module_name" or "module_args" are not defined in request |
invalid_schema |
JSON object received is not a dict object |
param_error |
"module_args" parameter was not parsed properly |
module_not_exist |
Module with given "module_name" does not exist for the database |
Status codes