Obtención de la API de estadísticas de archivos

Artículo
05/03/2024

Se aplica a:

¿Quiere experimentar Microsoft Defender para punto de conexión? Regístrese para obtener una prueba gratuita.

Nota:

Si es cliente del Gobierno de EE. UU., use los URI que aparecen en Microsoft Defender para punto de conexión para los clientes del Gobierno de EE. UU.

Sugerencia

Para mejorar el rendimiento, puede usar el servidor más cercano a la ubicación geográfica:

us.api.security.microsoft.com
eu.api.security.microsoft.com
uk.api.security.microsoft.com
au.api.security.microsoft.com
swa.api.security.microsoft.com

Descripción de la API

Recupera las estadísticas del archivo especificado.

Limitaciones

Las limitaciones de velocidad de esta API son 100 llamadas por minuto y 1500 llamadas por hora.
El valor máximo de lookbackhours es 720 Horas (30 días).

Permisos

Se requiere uno de los siguientes permisos para llamar a esta API. Para más información, incluido cómo elegir permisos, consulte Uso de api de Microsoft Defender para punto de conexión

Tipo de permiso	Permiso	Nombre para mostrar del permiso
Aplicación	File.Read.All	"Leer perfiles de archivo"
Delegado (cuenta profesional o educativa)	File.Read.All	"Leer perfiles de archivo"

Nota:

Al obtener un token con credenciales de usuario:

El usuario debe tener al menos el siguiente permiso de rol: "Ver datos" (para obtener más información, vea Create y administrar roles).

Solicitud HTTP

GET /api/files/{id}/stats

Encabezados de solicitud

Nombre	Tipo	Descripción
Authorization	Cadena	{token} de portador. Necesario.

Parámetros de URI de solicitud

Nombre	Tipo	Descripción
lookBackHours	Int32	Define las horas que se buscan para obtener las estadísticas. El valor predeterminado es 30 días. Opcional.

Cuerpo de la solicitud

En blanco

Respuesta

Si es correcto y el archivo existe: 200 Correcto con datos estadísticos en el cuerpo. Si el archivo no existe: 404 No encontrado.

Ejemplo

Ejemplo de solicitud

Este es un ejemplo de la solicitud.

GET https://api.security.microsoft.com/api/files/0991a395da64e1c5fbe8732ed11e6be064081d9f/stats?lookBackHours=48

Ejemplo de respuesta

Este es un ejemplo de la respuesta:

{
    "@odata.context": "https://api.security.microsoft.com/api/$metadata#microsoft.windowsDefenderATP.api.InOrgFileStats",
    "sha1": "0991a395da64e1c5fbe8732ed11e6be064081d9f",
    "organizationPrevalence": 14850,
    "orgFirstSeen": "2019-12-07T13:44:16Z",
    "orgLastSeen": "2020-01-06T13:39:36Z",
    "globallyPrevalence": 705012,
    "globalFirstObserved": "2015-03-19T12:20:07.3432441Z",
    "globalLastObserved": "2020-01-06T13:39:36Z",
    "topFileNames": [
        "MREC.exe"
    ]
}