Skip to main content
A newer release of this product is available.

volume quota policy rule modify

Contributors
Suggest changes

Modify an existing quota rule

Availability: This command is available to cluster and Vserver administrators at the admin privilege level.

Description

This command can be used to modify the following attributes of a quota policy rule:

  • User mapping

  • Hard disk limit

  • Hard file limit

  • Threshold for disk limit

  • Soft disk limit

  • Soft file limit

Note If the rule being modified belongs to the quota policy that is currently assigned to the Vserver, rule enforcement on the volume must be enabled by performing a quota off and on or a quota resize operation using the "volume quota modify " command.
This command is not supported on Infinite Volumes.

Parameters

-vserver <vserver name> - Vserver

This parameter specifies the Vserver containing the quota policy for which you are modifying a rule.

-policy-name <text> - Policy Name

This parameter specifies the name of the quota policy in which you are modifying a rule.

-volume <volume name> - Volume Name

This parameter specifies the name of the volume for which you are modifying a rule.

-type {tree|user|group} - Type

This parameter specifies the quota target type for the rule you are modifying.

-target <text> - Target

This parameter specifies the target to which the quota policy rule applies. If the target is a user, the user ID or username must be the same one that was used to create the quota. The same restriction is there for both group ID or groupname and Windows SID or Windows account name.

-qtree <qtree name> - Qtree Name

This parameter specifies the name of the qtree to which the quota policy rule applies.

[-user-mapping {on|off}] - User Mapping

This parameter optionally modifies the user mapping for a user quota rule. The value for this parameter can be modified only for quota policy rules of type user. A value of "on" can be specified for this parameter only if the quota target is a unix user name or a Windows user name and cannot be specified for multi-user quota targets. If this parameter is "on", the unix user name specified as the quota target will be mapped to the corresponding Windows user name or vice-versa and quota accounting will be performed for the users together.

[-disk-limit {<size>|-}] - Disk Limit

This parameter optionally modifies the hard limit for the disk space that can consumed by the quota target. The default unit for the disk limit is assumed to be Kilobytes if no units are specified. The value that you specify for this parameter should be greater than or equal to the threshold and soft disk limit. A disk limit of unlimited can be specified with a "-" for this parameter.

[-file-limit {<integer>|-}] - Files Limit

This parameter optionally modifies the hard limit for the number of files permitted on the quota target. The value that you specify for this parameter should be greater than or equal to the soft file limit. A file limit of unlimited can be specified with a "-" for this parameter

[-threshold {<size>|-}] - Threshold for Disk Limit

This parameter optionally modifies the disk limit threshold for the quota target. The default unit for the disk limit threshold is assumed to be Kilobytes if no units are specified. The value that you specify for this parameter should be greater than or equal to the soft disk limit and equal to or less than the disk limit. A threshold limit of unlimited can be specified with a "-" for this parameter.

[-soft-disk-limit {<size>|-}] - Soft Disk Limit

This parameter optionally modifies the soft limit for the disk space that can be consumed by the quota target. The default unit for the soft disk limit is assumed to be Kilobytes if no units are specified. The value that you specify for this parameter should be equal to or less than the threshold and the disk limit. A soft disk limit of unlimited can be specified with a "-" for this parameter.

[-soft-file-limit {<integer>|-}] - Soft Files Limit

This parameter optionally modifies the soft limit for the number of files permitted on the quota target. The value that you specify for this parameter should be equal to or less than the file limit. A soft file limit of unlimited can be specified with a "-" for this parameter.

Examples

The following example modifies a quota policy rule for the quota policy named quota_policy_0. This quota policy exists on Vserver vs0 and applies to the user named myuser for qtree named qtree1 on volume vol0. The user mapping is turned on, the hard disk limit is set to 20 GB and the hard file limit is set to 100,000 files.

cluster1::> volume quota policy rule modify -vserver vs0
-policy-name quota_policy_0  -volume vol0 -type user -target myuser
-qtree qtree1 -user-mapping on -disk-limit 20GB -file-limit 100000