Setting Quota for a Volume

Describes how to set disk quotas for a volume using either the Control System, the CLI or the REST API.

Setting Quota for a Volume Using the Control System

About this task

To set volume quotas, in the Summary tab under Data > Volumes:
NOTE The Volumes page is under the Volumes menu in the Kubernetes version of the Control System.

Procedure

  1. Ensure that the Quota column is displayed in the Volumes pane.
    If necessary, customize the columns to see the Quota column.
  2. Click the Set Quota link associated with the volume for which you want to set quotas to display the Set Quota window.
  3. Specify the following in the Set Quota window:
    1. Hard quota, which raises an alarm when the threshold is reached and prevents further writes.
      NOTE When you set a hard quota for a tiering-enabled volume, the quota is the total space allocated for the volume irrespective of the location (cluster or tier) where the volume data is stored. For example, if you allocate 1GB of hard quota for a tiering-enabled volume, writes will fail after you write 1GB of data whether or not the volume data is local (on the cluster) or offloaded (to the tier).
    2. Advisory quota, which raises an alarm when the threshold is reached, but does not prevent further writes.
    NOTE Both, advisory and hard, quotas can be expressed in megabytes (MB), gigabytes (GB), which is the default, or terabytes (TB).
  4. Click Save Changes for the changes to take effect.

Setting Quota for a Volume Using the CLI or the REST API

About this task

You can set quotas for a volume when creating a new or modifying an existing volume.

The basic command to set quota for a volume is:

maprcli volume create -name <volName> -path <mountPath> -advisoryquota <advisoryQuota> -quota <hardQuota>
maprcli volume modify -name <volName> -advisoryquota <advisoryQuota> -quota <hardQuota>
Send a request of type POST. For example:
curl -k -X POST 'https://<hostname>:8443/rest/volume/create?name=<volName>&path=<mountPath>&advisoryquota=<advisoryQuota>&quota=<hardQuota>' --user mapr:mapr
curl -k -X POST 'https://<hostname>:8443/rest/volume/modify?name=<volName>&advisoryquota=<advisoryQuota>&quota=<hardQuota>' --user mapr:mapr

For the complete list of required and optional parameters, see volume create and volume modify.