Setting or Modifying Quota for a Volume

Describes how to set or modify a quota for a volume.

About this task

You can set hard and advisory quotas for a volume using the Control System, CLI, and REST API. Hard quota is the total space allocated for the volume irrespective of the location (cluster or tier) where the volume data is stored. When the threshold for the hard quota is reached, an alarm is raised and further writes are not allowed. Advisory quota does not prevent further writes when the threshold is reached, but an alarm is raised.

Setting Quota for a Volume Using the Control System

About this task

You can set quota for a volume in the Volumes page and set or modify quotas for a volume in the volume information page.

Setting Quota for a Volume in the Volumes Page

Procedure

  1. Log in to the Control System and click Data > Volumes to display the Volumes page.
    NOTE
    The Volumes page is under the Volumes menu in the Kubernetes version of the Control System.
  2. Ensure that the Quota column is displayed in the Volumes pane.
    If necessary, customize the columns to see the Quota column.
  3. Click the Set Quota link associated with the volume for which you want to set quotas to display the Set Quota window.
  4. 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), terabytes (TB), petabytes (PB), exabytes (EB), and zettabytes (ZB).
  5. Click Save Changes for the changes to take effect.

Setting or Modifying Quotas for a Volume in the Volume Information Page

Procedure

  1. Log in to the Control System and go the Summary tab in the volume information page.
  2. Click the Edit Quota in the Quota Usage pane 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), terabytes (TB), petabytes (PB), exabytes (EB), and zettabytes (ZB).
  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 -X POST 'https://<hostname>:8443/rest/volume/create?name=<volName>&path=<mountPath>&advisoryquota=<advisoryQuota>&quota=<hardQuota>' --user <username>:<password>
curl -X POST 'https://<hostname>:8443/rest/volume/modify?name=<volName>&advisoryquota=<advisoryQuota>&quota=<hardQuota>' --user <username>:<password>

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