Obter API de estatísticas de arquivo

Artigo
05/03/2024

Aplica-se a:

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

Observação

Se você for um cliente do governo dos EUA, use as URIs listadas em Microsoft Defender para Ponto de Extremidade para clientes do governo dos EUA.

Dica

Para obter um melhor desempenho, você pode usar 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

Descrição da API

Recupera as estatísticas do arquivo determinado.

Limitações

As limitações de taxa para essa 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, consulte Usar APIs de Microsoft Defender para Ponto de Extremidade

Tipo de permissão	Permissão	Nome da exibição de permissão
Application	File.Read.All	'Ler perfis de arquivo'
Delegado (conta corporativa ou de estudante)	File.Read.All	'Ler perfis de arquivo'

Observação

Ao obter um token usando credenciais de usuário:

O usuário precisa ter pelo menos a seguinte permissão de função: 'Exibir dados' (Para obter mais informações, consulte Create e gerenciar 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.

Solicitar parâmetros URI

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

Corpo da solicitação

Vazio

Resposta

Se houver sucesso e o arquivo existir - 200 OK com dados estatísticos no corpo. Se o arquivo não existir – 404 Não encontrado.

Exemplo

Exemplo de solicitação

Aqui está um exemplo da solicitação.

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