Skip to main content

ONTAP commands for displaying information about quotas

Contributors netapp-aherbin netapp-aaron-holt

You can use commands to display a quota report containing enforced quotas and resource usage, display information about quota state and errors, or about quota policies and quota rules.

You can run the following commands only on FlexVol volumes.

If you want to…​ Use this command…​

View information about enforced quotas

volume quota report

View resource usage (disk space and number of files) of quota targets

volume quota report

Determine which quota limits are affected when a write to a file is allowed

volume quota report with the -path parameter

Display the quota state, such as on, off, and initializing

volume quota show

View information about quota message logging

volume quota show with the -logmsg parameter

View errors that occur during quota initialization and resizing

volume quota show with the -instance parameter

View information about quota policies

volume quota policy show

View information about quota rules

volume quota policy rule show

View the name of the quota policy that is assigned to a storage virtual machine (SVM, formerly known as Vserver)

vserver show with the -instance parameter

Learn more about volume quota in the ONTAP command reference.

When to use ONTAP volume quota policy rule show and volume quota report commands

Although both commands show information about quotas, the volume quota policy rule show quickly displays configured quota rules while the volume quota report command, which consumes more time and resources, displays enforced quotas and resource usage.

The volume quota policy rule show command is useful for the following purposes:

  • Check the configuration of quota rules before activating them

    This command displays all configured quota rules regardless of whether the quotas have been initialized or resized.

  • Quickly view quota rules without affecting system resources

    Because it does not display disk and file usage, this command is not as resource intensive as a quota report.

  • Display the quota rules in a quota policy that is not assigned to the SVM.

Learn more about volume quota policy rule show in the ONTAP command reference.

The volume quota report command is useful for the following purposes:

  • View enforced quotas, including derived quotas

  • View the disk space and number of files used by every quota in effect, including targets affected by derived quotas

    (For default quotas, the usage appears as "0" because the usage is tracked against the resulting derived quota.)

  • Determine which quota limits affect when a write to a file will be allowed

    Add the -path parameter to the volume quota report command.

Note

The quota report is resource-intensive operation. If you run it on many FlexVol volumes in the cluster, it might take a long time to complete. A more efficient way would be to view the quota report for a particular volume in an SVM.

Learn more about volume quota report in the ONTAP command reference.