|
| 1 | +--- |
| 2 | +title: Generate user and group quota reports for Azure NetApp Files volumes |
| 3 | +description: Learn how to generate user and group quota reports for Azure NetApp Files volumes. |
| 4 | +services: azure-netapp-files |
| 5 | +author: netapp-manishc |
| 6 | +ms.author: anfdocs |
| 7 | +ms.service: azure-netapp-files |
| 8 | +ms.topic: how-to |
| 9 | +ms.date: 11/11/2025 |
| 10 | +# Customer intent: As a cloud storage administrator, I want to generate user and group quota reports for Azure NetApp Files volumes. |
| 11 | +--- |
| 12 | +# Generate user and group quota reports for a volume (preview) |
| 13 | + |
| 14 | +To help with capacity management on volumes shared among multiple users, individual user and group quotas restrict capacity usage on NFS, SMB, and dual-protocol volumes. |
| 15 | + |
| 16 | +Quota reporting in Azure NetApp Files allows administrators to generate usage reports for an existing volume with quota rules, independent of host-based tooling and without having to mount the volume. |
| 17 | + |
| 18 | +For more information and considerations related to capacity management, see [Understand default and individual user and group quotas](default-individual-user-group-quotas-introduction.md). |
| 19 | + |
| 20 | +## Considerations |
| 21 | + |
| 22 | +* Quota reporting is specific to the volume and its quota rules. |
| 23 | +* Quota reports are supported on regular and large volumes. |
| 24 | +* Quota reports are compiled on demand. They aren't persisted. |
| 25 | +* Entries in the quota report are sorted by percentage used in descending order. |
| 26 | +* The number of entries in the quota report is currently capped at 1,000 entries. |
| 27 | +* The number of entries in the quota report can be larger than the number of quota rules on the volume. Users that are subjected to default quota are reported as individual quota report entries. |
| 28 | +* When using quota reporting on data protection volumes: |
| 29 | + * Quota report is unavailable for data protection volumes when the mirror state of the replication is in a mirrored state. You can run a quota report on the source volume instead. |
| 30 | + * Quota reports become available when the replication relation is broken. |
| 31 | +* On volumes without a default user/group quota, users that aren't mapped to any rules and are accessing the volume will show 0 for total disk limit and percentage used in the quota report. In this instance, consider creating a default user/group quota rule. |
| 32 | +* When requesting quota reports for multiple volumes in the same subscription, these quota report requests are processed sequentially. When using the API, check responses (specifically percentComplete) for status. The quota report slide out in the Azure portal automatically retrieves the quota report in the background. Stay on the page until the quota report is successfully retrieved. |
| 33 | +* Quota reports take five seconds on average to generate. |
| 34 | +* If the quota report is an empty list or the quota report API calls fail on a volume with quota rules, retry generating the quota report after five minutes. |
| 35 | +* If quota rules aren't aligned with 4 KiB, the quota limit is incorrectly reported in the quota report. This happens because the field is always rounded up to the nearest multiple of 4 KiB to match disk space limits, which are translated into 4-KiB chunks. |
| 36 | + |
| 37 | +## Register the feature |
| 38 | + |
| 39 | +The feature must be registered on your subscription before using it for the first time. After confirmation by the product team, the feature is enabled on your subscription. |
| 40 | + |
| 41 | +1. Register the feature: |
| 42 | + |
| 43 | + ```azurepowershell-interactive |
| 44 | + Register-AzProviderFeature -ProviderNamespace Microsoft.NetApp -FeatureName ANFFetchQuotaReport |
| 45 | + ``` |
| 46 | + |
| 47 | +2. Check the status of the feature registration: |
| 48 | + |
| 49 | + > [!NOTE] |
| 50 | + > The **RegistrationState** can remain in the `Registering` state for up to 60 minutes before changing to `Registered`. Wait until the status is **Registered** before continuing. |
| 51 | + |
| 52 | + ```azurepowershell-interactive |
| 53 | + Get-AzProviderFeature -ProviderNamespace Microsoft.NetApp -FeatureName ANFFetchQuotaReport |
| 54 | + ``` |
| 55 | + |
| 56 | +You can also use [Azure CLI commands](/cli/azure/feature) `az feature register` and `az feature show` to register the feature and display the registration status. |
| 57 | + |
| 58 | +## Generate a quota report for a volume |
| 59 | + |
| 60 | +1. From the Azure portal, select the volume for which you want to generate a quota report. |
| 61 | +2. Navigate to **User and group quotas**. Select the **Quota Report and Management** tab from the actions menu to generate the report. |
| 62 | + |
| 63 | +  |
| 64 | + |
| 65 | + The quota report is retrieved in the background. Remain on the page until the quota report has been successfully retrieved. Retrieval takes an average of five seconds, but can take longer. The quota report lists one entry per user. The following fields are available: |
| 66 | + |
| 67 | + * **Quota Type** |
| 68 | + |
| 69 | + Indicates which type of quota rule caused this user or group entry in the report. Possible types are default or individual quotas for users or groups. |
| 70 | + |
| 71 | + * **Derived Quota** |
| 72 | + |
| 73 | + If a user or group is subject to an explicit quota rule, this field displays "No." Conversely, if a user or group is implicitly subject to a quota rule such as a default user or group quota rule, this field displays "Yes." |
| 74 | + |
| 75 | + * **Quota Target** |
| 76 | + |
| 77 | + UID/SID/GID for user/group |
| 78 | + |
| 79 | + * **Quota Used** |
| 80 | + |
| 81 | + Total disk limit used by the user/group |
| 82 | + |
| 83 | + * **Quota Limit** |
| 84 | + |
| 85 | + Total disk limit allocated by the user/group in kilobyte |
| 86 | + |
| 87 | + * **% Used** |
| 88 | + |
| 89 | + Displays information with quota usage equal to or greater than the percentage used |
| 90 | + |
| 91 | +3. You can apply filters for **Quota Target**, **Quota Type**, and **% Used** to view a specific subset of the quota report. |
| 92 | + |
| 93 | +> [!IMPORTANT] |
| 94 | +> When using the quota target filter, you must first select a quota type value. The quota target is dependent on the quota type and can't be applied independently. |
| 95 | +
|
| 96 | +> [!NOTE] |
| 97 | +> You can add a new quota only for derived quotas. You can only edit non-derived quotas. |
| 98 | +
|
| 99 | +4. To edit a quota, select `…` at the end of the quota rule row, then select **Edit**. |
| 100 | + |
| 101 | + |
| 102 | + |
| 103 | +5. To add a new quota for the default user and group quota, select `…` at the end of the quota rule row then **Add**. |
| 104 | + |
| 105 | + |
| 106 | + |
| 107 | +## Next steps |
| 108 | + |
| 109 | +* [Understand default and individual user and group quotas](default-individual-user-group-quotas-introduction.md) |
| 110 | +* [Manage default and individual user and group quotas for a volume](manage-default-individual-user-group-quotas.md) |
0 commit comments