A newer version of this documentation is available.

View Latest

Changing Bucket Parameters

    To modify bucket parameters, use the POST /pools/default/buckets/[bucket-name] HTTP method and URI with the bucket name being the REST API endpoint.


    You can modify existing bucket parameters by posting the updated parameters used to create the bucket to the bucket’s URI. Do not omit a parameter in your request since this is equivalent to not setting it in many cases. We recommend you do a request to get current bucket settings, make modifications as needed and then make your POST request to the bucket URI.

    The bucket name cannot be changed via the REST API.
    When changing the active bucket configuration, specify the existing configuration parameters and the changed authentication parameters.


    Curl request syntax:

    curl -v -X POST -u [admin]:[password]
      -d name=[customer]
      -d flushEnabled=[0 | 1]
      -d replicaNumber=[value from 0 to 3]
      -d authType=[none | sasl]
      -d ramQuotaMB=[value]
      -d proxyPort=[port]


    Curl request example:

    To edit the bucket customer on server node

    curl -v -X POST -u Administrator:password \
      -d 'name=customer' \
      -d 'flushEnabled=0' \
      -d 'replicaNumber=1' \
      -d 'authType=none' \
      -d 'ramQuotaMB=200' \
      -d 'proxyPort=11212' \


    If the request is successful, HTTP response 200 is returned with an empty data content.

    202 OK

    Response codes

    Response codes Description