Skip to main content

Microsoft 365 | Limitation Retrieving Current SharePoint Tenant Storage Capacity via Microsoft Graph

This article explains why tenant-level SharePoint storage capacity cannot currently be retrieved by the Liongard Microsoft 365 Inspector and why storage alerting is not supported.

Updated yesterday

💥 Overview

Partners frequently ask whether the Liongard Microsoft 365 Inspector can alert when SharePoint Online storage is approaching the tenant’s maximum capacity.

At this time, tenant-wide SharePoint storage capacity cannot be retrieved by the Inspector.


As a result, reliable alerting on total SharePoint storage utilization is not currently supported.

This limitation is caused by the data currently collected by the Inspector and by the way Microsoft exposes SharePoint storage data through supported APIs. It is not a metric configuration issue.


🤔 Why This Limitation Exists

The Inspector collects SharePoint storage data using the Microsoft Graph API.

The Inspector currently uses Microsoft Graph drive endpoints for SharePoint storage-related data. Those drive endpoints expose quota information for individual drives or document libraries, not the tenant’s overall SharePoint storage pool.

Microsoft Graph does include SharePoint usage reporting endpoints, but they do not provide the same straightforward current tenant storage pool values that would be needed for reliable tenant-capacity alerting in this Inspector.

Using the storage data currently collected by the Inspector, it is not possible to reliably determine:

  • the organization’s total SharePoint storage pool

  • current remaining tenant storage

  • current tenant-wide percentage used

  • a reliable threshold for tenant-capacity alerting

While Microsoft provides some SharePoint usage reporting, it does not map cleanly to a simple live tenant-capacity calculation within this Inspector.


🔍 Endpoints Used by the Inspector

The Inspector retrieves document library storage information using:

/sites/{site-id}/drives
/sites/{site-id}/drive

These endpoints return quota properties for individual drives (document libraries).


📦 What the Returned Quota Values Represent

The drive.quota values returned by Microsoft Graph represent quota constraints on a specific drive resource, such as a SharePoint document library. These values should not be treated as the organization’s total SharePoint tenant storage capacity.

Common characteristics include:

  • Often shows very large limits (for example, ~25 TB)

  • May repeat across multiple libraries within the same site

  • Represents quota constraints for that drive or site context, rather than the tenant storage pool.

  • Does not reflect purchased tenant storage


❌ Why Summing Drive Quotas Produces Inaccurate Results

Metrics that attempt to estimate tenant storage by summing drive quota values will produce inflated or misleading totals.

Key reasons:

Duplicate Values Across Libraries

Multiple document libraries within a single site can report identical quota limits.

Logical Limits vs. Physical Capacity

Site quotas define allowed growth per site, not available tenant storage.

No Awareness of Shared Storage Pool

Graph quota data does not include context about tenant-wide allocation or remaining capacity.

Because of these factors, aggregated results do not represent real SharePoint usage.


🧭 Site-Level Quota vs. Tenant Storage Pool

Understanding this distinction is critical.

Site-Level Drive Quota (Available via Inspector)

Represents:

✔ Maximum allowed size for a specific site or library
✔ Administrative configuration
✖ Not tied to purchased tenant storage
✖ Not suitable for capacity monitoring

Tenant-Level Storage Pool (Not Available in the Inspector)

Actual SharePoint storage capacity is surfaced through Microsoft administrative tooling, such as the SharePoint Admin Center, which shows total and available storage for the organization. Microsoft also documents organization-level storage properties through SharePoint Online PowerShell cmdlets, such as Get-SPOTenant.

This tenant-level view includes:

✔ Total storage purchased for the organization
✔ Storage consumed across all sites
✔ Remaining available capacity
✔ Accurate capacity monitoring information


⚠️ Common Misconception

This is not a metric logic issue.

Even correctly written metrics cannot produce accurate tenant storage calculations because the underlying data does not represent tenant capacity.


🚫 Can I Alert When SharePoint Is Nearing Maximum Storage?

No — not currently.

Because tenant-wide storage capacity cannot be retrieved, the Inspector cannot determine when SharePoint is approaching its maximum storage limit.

No reliable workaround exists within the Liongard platform at this time.


📊 Recommended Monitoring Approach

Until tenant storage data becomes accessible through supported APIs, organizations should monitor SharePoint capacity using Microsoft administrative tools, such as:

  1. SharePoint Admin Center

  2. Microsoft 365 usage reports

  3. Native Microsoft alerting / admin monitoring

  4. SharePoint Online administrative tooling, where applicable


🧩 What Would Be Required to Support This Use Case

Accurate tenant-level monitoring would require a supported data source that exposes the organization’s SharePoint storage pool directly, such as SharePoint administrative tooling or a Microsoft-supported reporting source that can be reliably mapped to tenant-capacity thresholds. Those sources are not currently used by the Inspector for this purpose.


🦁 When to Contact Liongard Support

Contact Liongard Support if:

  • You need clarification on SharePoint monitoring capabilities.

  • Metrics appear incorrect for site-level quota reporting.

  • You require guidance on alternative monitoring approaches.

Did this answer your question?