API Per ottenere statistiche IPGet IP statistics API

Si applica a:Applies to:

Vuoi provare Defender per Endpoint?Want to experience Defender for Endpoint? Iscriversi per una versione di valutazione gratuita.Sign up for a free trial.

Nota

Se sei un cliente us government, usa gli URI elencati in Microsoft Defender for Endpoint per i clienti del governo statunitense.If you are a US Government customer, please use the URIs listed in Microsoft Defender for Endpoint for US Government customers.

Suggerimento

Per ottenere prestazioni migliori, è possibile utilizzare il server più vicino alla posizione geografica: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

Descrizione APIAPI description

Recupera le statistiche per l'IP specificato.Retrieves the statistics for the given IP.

LimitazioniLimitations

  1. I limiti di frequenza per questa API sono 100 chiamate al minuto e 1500 chiamate all'ora.Rate limitations for this API are 100 calls per minute and 1500 calls per hour.

AutorizzazioniPermissions

Per chiamare questa API è necessaria una delle autorizzazioni seguenti.One of the following permissions is required to call this API. Per altre informazioni, inclusa la scelta delle autorizzazioni, vedi Usare Microsoft Defender per le API endpointTo learn more, including how to choose permissions, see Use Microsoft Defender for Endpoint APIs

Tipo di autorizzazionePermission type AutorizzazionePermission Nome visualizzato autorizzazionePermission display name
ApplicazioneApplication Ip.Read.AllIp.Read.All "Lettura dei profili degli indirizzi IP"'Read IP address profiles'
Delegato (account aziendale o dell'istituto di istruzione)Delegated (work or school account) Ip.Read.AllIp.Read.All "Lettura dei profili degli indirizzi IP"'Read IP address profiles'

Nota

Quando si ottiene un token utilizzando le credenziali utente:When obtaining a token using user credentials:

  • L'utente deve disporre almeno dell'autorizzazione di ruolo seguente: 'Visualizza dati' (per ulteriori informazioni, vedere Creare e gestire ruoli)The user needs to have at least the following role permission: 'View Data' (See Create and manage roles for more information)

Richiesta HTTPHTTP request

GET /api/ips/{ip}/stats

Intestazioni di richiestaRequest headers

NomeName TipoType DescrizioneDescription
AutorizzazioneAuthorization StringaString Bearer {token}.Bearer {token}. Obbligatorio.Required.

Parametri URI di richiestaRequest URI parameters

NomeName TipoType DescrizioneDescription
lookBackHourslookBackHours Int32Int32 Definisce le ore di ricerca per ottenere le statistiche.Defines the hours we search back to get the statistics. Il valore predefinito è 30 giorni.Defaults to 30 days. Facoltativo.Optional.

Corpo della richiestaRequest body

VuotoEmpty

RispostaResponse

Se ha esito positivo e ip esiste - 200 OK con dati statistici nel corpo.If successful and ip exists - 200 OK with statistical data in the body. IP non esistente - 404 Non trovato.IP do not exist - 404 Not Found.

EsempioExample

RichiestaRequest

Ecco un esempio della richiesta.Here is an example of the request.

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

RispostaResponse

Ecco un esempio di risposta.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 DescrizioneDescription
Prevalenza dell'organizzazioneOrganization prevalence il conteggio distinto dei dispositivi che hanno aperto la connessione di rete a questo IP.the distinct count of devices that opened network connection to this IP.
Org first seenOrg first seen la prima connessione per questo INDIRIZZO IP nell'organizzazione.the first connection for this IP in the organization.
Org last seenOrg last seen l'ultima connessione per questo INDIRIZZO IP nell'organizzazione.the last connection for this IP in the organization.

Nota

Queste informazioni statistiche si basano sui dati degli ultimi 30 giorni.This statistic information is based on data from the past 30 days.