reportRoot: getOneDriveUsageStorage

Espacio de nombres: microsoft.graph

Obtiene las tendencias sobre la cantidad de almacenamiento que usa en OneDrive para la Empresa.

Nota: Para obtener más información sobre diferentes vistas y nombres de informes, vea Microsoft 365 informes - OneDrive para la Empresa uso.

Permisos

Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.

Tipo de permiso Permisos (de menos a más privilegiados)
Delegado (cuenta profesional o educativa) Reports.Read.All
Delegado (cuenta personal de Microsoft) No admitida.
Aplicación Reports.Read.All

Nota: Para permisos delegados a fin de permitir que las aplicaciones lean los informes de uso del servicio en nombre de un usuario, el administrador de la cuenta empresarial debe haber asignado al usuario un rol de administrador limitado apropiado en Azure AD. Para obtener más información, vea Autorización para que las API lean informes de uso de Microsoft 365.

Solicitud HTTP

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

Parámetros de función

En la URL de la solicitud, especifique el siguiente parámetro de consulta con un valor válido.

Parámetro Tipo Descripción
period cadena Especifica la duración de tiempo durante la que se agrega el informe. Los valores admitidos para {period_value} son: D7, D30, D90 y D180. Estos valores tienen el formato D n, donde n representa el número de días durante los que se agrega el informe. Necesario.

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio.
If-None-Match Si se incluye este encabezado de solicitud y la etiqueta electrónica proporcionada coincide con la etiqueta actual en el archivo, se devuelve un código de respuesta 304 Not Modified. Opcional.

Respuesta

Si se ejecuta correctamente, este método devuelve una respuesta 302 Found que redirige a una URL de descarga con autenticación previa para el informe. La URL se encuentra en el encabezado Location de la respuesta.

Las URL de descarga con autenticación previa solo son válidas durante un breve período de tiempo (unos minutos) y no necesitan un encabezado Authorization para descargarlas.

El archivo CSV tiene los siguientes encabezados de columna.

  • Fecha de actualización del informe
  • Tipo de sitio
  • Almacenamiento usado (bytes)
  • Fecha del informe
  • Período del informe

Ejemplo

Solicitud

Aquí tiene un ejemplo de la solicitud.

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

Respuesta

Este es un ejemplo de la respuesta.

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

Siga el redireccionamiento 302 y el archivo CSV descargado tendrá el esquema siguiente.

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

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