Obter API de estatísticas IPGet IP statistics API

Aplica-se a:Applies to:

Deseja experimentar o Defender para Ponto de Extremidade?Want to experience Defender for Endpoint? Inscreva-se para uma avaliação gratuita.Sign up for a free trial.

Observação

Se você for um cliente do Governo dos EUA, use os URIs listados no Microsoft Defender for Endpoint para clientes do Governo dos EUA.If you are a US Government customer, please use the URIs listed in Microsoft Defender for Endpoint for US Government customers.

Dica

Para melhorar o desempenho, você pode usar o servidor mais próximo de sua localização geográfica:For better performance, you can use server closer to your geo location:

  • api-us.securitycenter.microsoft.comapi-us.securitycenter.microsoft.com
  • api-eu.securitycenter.microsoft.comapi-eu.securitycenter.microsoft.com
  • api-uk.securitycenter.microsoft.comapi-uk.securitycenter.microsoft.com

Descrição da APIAPI description

Recupera as estatísticas do IP determinado.Retrieves the statistics for the given IP.

LimitaçõesLimitations

  1. Limitações de taxa para essa API são 100 chamadas por minuto e 1500 chamadas por hora.Rate limitations for this API are 100 calls per minute and 1500 calls per hour.

PermissõesPermissions

Uma das seguintes permissões é necessária para chamar essa API.One of the following permissions is required to call this API. Para saber mais, incluindo como escolher permissões, consulte Use Microsoft Defender for Endpoint APIsTo learn more, including how to choose permissions, see Use Microsoft Defender for Endpoint APIs

Tipo de permissãoPermission type PermissãoPermission Nome de exibição de permissãoPermission display name
AplicativoApplication Ip.Read.AllIp.Read.All 'Ler perfis de endereço IP''Read IP address profiles'
Delegado (conta corporativa ou de estudante)Delegated (work or school account) Ip.Read.AllIp.Read.All 'Ler perfis de endereço IP''Read IP address profiles'

Observação

Ao obter um token usando credenciais de usuário:When obtaining a token using user credentials:

  • O usuário precisa ter pelo menos a seguinte permissão de função: 'Exibir Dados' (Consulte Criar e gerenciar funções para obter mais informações)The user needs to have at least the following role permission: 'View Data' (See Create and manage roles for more information)

Solicitação HTTPHTTP request

GET /api/ips/{ip}/stats

Cabeçalhos de solicitaçãoRequest headers

NomeName TipoType DescriçãoDescription
AutorizaçãoAuthorization Cadeia de caracteresString Portador {token}.Bearer {token}. Obrigatório.Required.

Solicitar parâmetros URIRequest URI parameters

NomeName TipoType DescriçãoDescription
lookBackHourslookBackHours Int32Int32 Define as horas que pesquisamos de volta para obter as estatísticas.Defines the hours we search back to get the statistics. O padrão é 30 dias.Defaults to 30 days. Opcional.Optional.

Corpo da solicitaçãoRequest body

VazioEmpty

RespostaResponse

Se bem-sucedido e ip existir - 200 OK com dados estatísticos no corpo.If successful and ip exists - 200 OK with statistical data in the body. IP não existe - 404 Não Encontrado.IP do not exist - 404 Not Found.

ExemploExample

SolicitaçãoRequest

Este é um exemplo da solicitação.Here is an example of the request.

GET https://api.securitycenter.microsoft.com/api/ips/10.209.67.177/stats?lookBackHours=48

ResponseResponse

Veja a seguir um exemplo da resposta.Here is an example of the response.

{
    "@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#microsoft.windowsDefenderATP.api.InOrgIPStats",
    "ipAddress": "10.209.67.177",
    "organizationPrevalence": 63515,
    "orgFirstSeen": "2017-07-30T13:36:06Z",
    "orgLastSeen": "2017-08-29T13:32:59Z"
}
NomeName DescriçãoDescription
Prevalência da organizaçãoOrganization prevalence a contagem distinta de dispositivos que abriram a conexão de rede a esse IP.the distinct count of devices that opened network connection to this IP.
Org visto pela primeira vezOrg first seen a primeira conexão para esse IP na organização.the first connection for this IP in the organization.
Org visto pela última vezOrg last seen a última conexão para esse IP na organização.the last connection for this IP in the organization.

Observação

Essas informações estatísticas se baseiam nos dados dos últimos 30 dias.This statistic information is based on data from the past 30 days.