MethodPathDescription
POST/v1/bdbs/{uid}/modules/configConfigure 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

Permission name
edit_bdb_module

Request

Example HTTP request

POST /bdbs/1/modules/config

Example JSON body

{
  "modules": [
    {
      "module_name": "search",
      "module_args": "MINPREFIX 3 MAXEXPANSIONS 1000"
    }
  ]
}

Request headers

KeyValueDescription
Hostcnm.cluster.fqdnDomain name
Acceptapplication/jsonAccepted media type

Request body

FieldTypeDescription
moduleslist of JSON objectsList of modules (module_name) and their new configuration settings (module_args)
module_namesearch
ReJSON
graph
timeseries
bf
Module’s name
module_argsstringModule 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:

CodeDescription
db_not_existDatabase with given UID doesn’t exist in cluster
missing_field“module_name” or “module_args” are not defined in request
invalid_schemaJSON object received is not a dict object
param_error“module_args” parameter was not parsed properly
module_not_existModule with given “module_name” does not exist for the database

Status codes

CodeDescription
200 OKSuccess, module updated on bdb.
404 Not Foundbdb not found.
400 Bad RequestBad or missing configuration parameters.
406 Not AcceptableModule does not support runtime configuration of arguments.