Configure module requests
Configure module requests
| Redis Enterprise Software |
|---|
| Method | Path | Description |
|---|---|---|
| POST | /v1/modules/config/bdb/{uid} |
Configure module |
Configure module
POST /v1/modules/config/bdb/{string: uid}
Use the module runtime configuration command (if defined) to configure new arguments for the module.
Required permissions
| Permission name |
|---|
| edit_bdb_module |
Request
Example HTTP request
POST /v1/modules/config/bdb/1
Example JSON body
{
"modules": [
{
"module_name": "search",
"module_args": "MINPREFIX 3 MAXEXPANSIONS 1000"
}
]
}
Request headers
| 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 | searchReJSONgraphtimeseriesbf |
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
| Code | Description |
|---|---|
| 200 OK | Success, module updated on bdb. |
| 404 Not Found | bdb not found. |
| 400 Bad Request | Bad or missing configuration parameters. |
| 406 Not Acceptable | Module does not support runtime configuration of arguments. |