Articles in this section

quota modify

Sara Levy
  • Updated
Follow

This command modifies a quota.

Usage
quota modify --id ID
            [--name NAME]
            [--grace-period GRACE-PERIOD]
            [--soft-limit SOFT-LIMIT]
            [--hard-limit HARD-LIMIT]
            [--hard-limit-inodes HARD-LIMIT-INODES]
            [--soft-limit-inodes SOFT-LIMIT-INODES]
            [--enable-email-providers]
            [--disable-email-providers]
            [--default-user-quota DEFAULT_USER_QUOTA]
            [--default-group-quota DEFAULT_GROUP_QUOTA]
Required Parameters

--id ID

Specifies which quota to modify.
Options

--name NAME

Changes the name of the quota.

--grace-period GRACE-PERIOD

Sets or modifies a grace period. If the storage usage continues to exceed the soft limit for the period of time set as the grace period, an alarm is triggered and write operations to the directory are blocked. 

If no grace period is set, the directory is only blocked if and when usage reaches the hard limit. 

Specify GRACE_PERIOD in the format: [DD] [HH:[MM:]]ss or as an integer followed by d for days, h for hours, m for minutes, or s for seconds. Examples:

  • To specify 30 days, 20 hours, 15 minutes and 10 seconds: --grace-period 30 20:15:10.

  • To specify 18 hours: --grace-period 18:00.

  • To specify 7 days: --grace-period 7d

--soft-limit SOFT-LIMIT

Sets or modifies a storage usage soft limit. Warnings of exceeding the quota are issued when this limit is reached.

If not specified, no soft limit is applied.

--hard-limit HARD-LIMIT

Sets or modifies a storage usage limit. No writes are allowed beyond this limit.

When the hard limit is reached, the HARD_EXCEEDED alarm is triggered.

The value must be a complete integer and must be specified with a unit of measurement. Do not insert a space between the value and the unit of measurements. Valid units are:

  • Base 10: KB, MB, GB, TB, PB, EB,

  • Base 2: KiB, MiB, GiB, TiB, PiB, EiB

The units are case-insensitive. For example: 4gb is valid. 

If not specified, no hard limit is applied.

--hard-limit-inodes HARD-LIMIT-INODES

Sets or modifies a limit on the number of directories and unique files under the path. No writes are allowed beyond this limit. A file with multiple hardlinks is counted only once.

--soft-limit-inodes SOFT-LIMIT-INODES

Sets or modifies a soft limit on the number of directories and unique files under the path. Warnings of exceeding the quota are issued when the limit is reached. A file with multiple hardlinks is counted only once.

--enable-email-providers

Relevant for user quotas, enables querying of providers for user email addresses used to send email notifications to users when they exceed user quotas.

--disable-email-providers

Relevant for user quotas, disables querying of providers for user addresses used to send email notifications to users when they exceed user quotas.

--default-user-quota DEFAULT_USER_QUOTA

Specifies the configuration of a default user quota. If configured, the default user quota is applied to users without individual quotas.

For example: --default-user-quota 'soft_limit=4,hard_limit=20,soft_limit_inodes=6,hard_limit_inodes=9,grace_period=00:10:00'

--default-group-quota DEFAULT_GROUP_QUOTA

Specifies the configuration of a default group quota. If configured, the default group quota is applied to groups without individual quotas.

For example: --default-group-quota 'soft_limit=4,hard_limit=20,soft_limit_inodes=6,hard_limit_inodes=9,grace_period=00:10:00'
Example
vcli: admin> quota modify --id 4  --grace-period 8h
Are you sure you want to modify the quota? [y/N] y

Related articles

Comments

0 comments

Article is closed for comments.