Obter a API de estatísticas de ficheiros

Artigo
02/20/2025

Aplica-se a:

Deseja experimentar o Microsoft Defender para Ponto de Extremidade? Inscreva-se para uma avaliação gratuita.

Observação

Se for um cliente do Governo norte-americano, utilize os URIs listados no Microsoft Defender para Ponto de Extremidade para clientes do Us Government.

Dica

Para um melhor desempenho, pode utilizar o servidor mais próximo da localização 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
ina.api.security.microsoft.com

Descrição da API

Obtém as estatísticas do ficheiro especificado.

Limitações

As limitações de taxa para esta API são 100 chamadas por minuto e 1500 chamadas por hora.
O valor máximo para lookbackhours é 720 Horas(30 dias).

Permissões

Uma das seguintes permissões é necessária para chamar esta API. Para saber mais, incluindo como escolher permissões, veja Utilizar Microsoft Defender para Ponto de Extremidade APIs

Tipo de permissão	Permissão	Nome a apresentar da permissão
Application	File.Read.All	"Ler perfis de ficheiro"
Delegado (conta corporativa ou de estudante)	File.Read.All	"Ler perfis de ficheiro"

Observação

Ao obter um token com credenciais de utilizador:

O utilizador tem de ter, pelo menos, a seguinte permissão de função: "Ver Dados" (Para obter mais informações, consulte Criar e gerir funções)

Solicitação HTTP

GET /api/files/{id}/stats

Cabeçalhos de solicitação

Nome	Tipo	Descrição
Autorização	Cadeia de caracteres	{token} de portador. Obrigatório.

Pedir parâmetros de URI

Nome	Tipo	Descrição
lookBackHours	Int32	Define as horas que pesquisamos para obter as estatísticas. A predefinição é 30 dias. Opcional.

Corpo da solicitação

Vazio

Resposta

Se tiver êxito e o ficheiro existir - 200 OK com dados estatísticos no corpo. Se o ficheiro não existir – 404 Não Encontrado.

Exemplo

Exemplo de solicitação

Eis um exemplo do pedido.

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

Exemplo de resposta

Veja um exemplo de resposta.

{
    "@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"
    ]
}