Loading TOC...

PUT /manage/v2/databases/{id|name}/rebalancer


Update the rebalancer configuration for a database.

Request Headers
Content-type The MIME type of the data in the request body. Supported values: application/xml, application/json.


Upon success, MarkLogic Server returns status code 204 (No Content).

Required Privileges

This operation requires the manage-admin role, or the following privilege:


Usage Notes

You can modify the following configuration settings:

You can include one or more properties in the input configuration. Properties not included are unchanged. For details, see Database Rebalancing in the Administrator's Guide.

The structure of the data in the request body is as follows:


Enable automatic rebalancing after configuration changes.


Larger numbers mean work harder at rebalancing.


$ cat reb-config.xml
<database-rebalancer-properties xmlns="http://marklogic.com/manage" 

$ cat reb-config.json

$ curl --anyauth --user user:password -X PUT -d @./reb-config.xml \
    -i -H "Accept: application/xml" \

==> The rebalancer configuration is modified. MarkLogic Server returns
    status code 204 (No Content) and headers similar to the following:

HTTP/1.1 204 No Content
Server: MarkLogic
Content-Length: 0
Connection: Keep-Alive

Stack Overflow iconStack Overflow: Get the most useful answers to questions from the MarkLogic community, or ask your own question.