reportRoot : getSharePointSiteUsageStoragereportRoot: getSharePointSiteUsageStorage

Espace de noms: microsoft.graphNamespace: microsoft.graph

Obtenir la tendance de stockage alloué et utilisé pendant la période de rapport.Get the trend of storage allocated and consumed during the reporting period.

Remarque : Pour plus d’informations sur les différents noms et vues de rapport, voir rapports Microsoft 365-utilisation du site SharePoint.Note: For details about different report views and names, see Microsoft 365 reports - SharePoint site usage.

AutorisationsPermissions

L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Type d’autorisationPermission type Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)Permissions (from least to most privileged)
Déléguée (compte professionnel ou scolaire)Delegated (work or school account) Reports.Read.AllReports.Read.All
Déléguée (compte Microsoft personnel)Delegated (personal Microsoft account) Non prise en charge.Not supported.
ApplicationApplication Reports.Read.AllReports.Read.All

Remarque : pour que les autorisations déléguées permettent aux applications de lire les rapports d’utilisation des services pour le compte d’un utilisateur, l’administrateur du locataire doit avoir attribué le rôle d’administrateur limité Azure AD approprié à l’utilisateur.Note: For delegated permissions to allow apps to read service usage reports on behalf of a user, the tenant administrator must have assigned the user the appropriate Azure AD limited administrator role. Si vous souhaitez en savoir plus, veuillez consulter la rubriqueAutorisation pour les API de lire les rapports d'utilisation de Microsoft 365.For more details, see Authorization for APIs to read Microsoft 365 usage reports.

Requête HTTPHTTP request

GET /reports/getSharePointSiteUsageStorage(period='{period_value}')

Paramètres de fonctionFunction parameters

Dans l’URL de la requête, indiquez une valeur valide pour le paramètre suivant.In the request URL, provide the following parameter with a valid value.

ParamètreParameter TypeType DescriptionDescription
pointperiod stringstring Spécifie la durée de regroupement du rapport.Specifies the length of time over which the report is aggregated. Les valeurs prises en charge pour {period_value} sont les suivantes : D7, D30, D90 et D180.The supported values for {period_value} are: D7, D30, D90, and D180. Ces valeurs suivent le format Dn, où n représente le nombre de jours pendant lesquels le rapport est regroupé.These values follow the format Dn where n represents the number of days over which the report is aggregated. Obligatoire.Required.

En-têtes de demandeRequest headers

NomName DescriptionDescription
AutorisationAuthorization Porteur {token}. Obligatoire.Bearer {token}. Required.
If-None-MatchIf-None-Match Si cet en-tête de demande est inclus et que l’eTag fourni correspond à la balise actuelle sur le fichier, un code de réponse 304 Not Modified est renvoyé.If this request header is included and the eTag provided matches the current tag on the file, a 304 Not Modified response code is returned. Facultatif.Optional.

RéponseResponse

Si elle réussit, cette méthode renvoie une réponse 302 Found qui redirige vers une URL de téléchargement préalablement authentifiée pour le rapport.If successful, this method returns a 302 Found response that redirects to a preauthenticated download URL for the report. Cette URL est accessible dans l’en-tête Location de la réponse.That URL can be found in the Location header in the response.

Les URL de téléchargement préalablement authentifiées ne sont valides que pour une courte durée (quelques minutes) et ne nécessitent pas d’en-tête Authorization.Preauthenticated download URLs are only valid for a short period of time (a few minutes) and do not require an Authorization header.

Le fichier CSV comporte les en-têtes de colonnes suivants.The CSV file has the following headers for columns.

  • Date d’actualisation du rapportReport Refresh Date
  • Type de siteSite Type
  • Espace de stockage utilisé (octets)Storage Used (Byte)
  • Date du rapportReport Date
  • Période du rapportReport Period

ExempleExample

DemandeRequest

Voici un exemple de demande.The following is an example of the request.

GET https://graph.microsoft.com/v1.0/reports/getSharePointSiteUsageStorage(period='D7')

RéponseResponse

Voici un exemple de réponse.The following is an example of the response.

HTTP/1.1 302 Found
Content-Type: text/plain
Location: https://reports.office.com/data/download/JDFKdf2_eJXKS034dbc7e0t__XDe

Suivez la redirection 302 et le fichier CSV téléchargé aura le schéma suivant.Follow the 302 redirection and the CSV file that downloads will have the following schema.

HTTP/1.1 200 OK
Content-Type: application/octet-stream

Report Refresh Date,Site Type,Storage Used (Byte),Report Date,Report Period