Ottenere l'API dei computer correlati al dominio

Articolo
2024-11-05

Si applica a:

Se si desidera provare Microsoft Defender per endpoint, iscriversi a una versione di valutazione gratuita.

Nota

Se si è un cliente del governo degli Stati Uniti, usare gli URI elencati in Microsoft Defender per endpoint per i clienti del governo degli Stati Uniti.

Consiglio

Per ottenere prestazioni migliori, è possibile usare il server più vicino alla posizione geografica:

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

Descrizione DELL'API

Recupera una raccolta di computer che hanno comunicato a o da un determinato indirizzo di dominio.

Limitazioni

È possibile eseguire query sull'ultimo aggiornamento dei dispositivi in base al periodo di conservazione configurato.
Le limitazioni di frequenza per questa API sono 100 chiamate al minuto e 1500 chiamate all'ora.
Le risposte sono limitate a 500 dispositivi nei risultati.

Autorizzazioni

Per chiamare questa API è necessaria una delle autorizzazioni seguenti. Per altre informazioni, inclusa la scelta delle autorizzazioni, vedere Usare le API Microsoft Defender per endpoint

Tipo di autorizzazione	Autorizzazione	Nome visualizzato autorizzazioni
Applicazione	`Machine.Read.All`	`Read all machine profiles`
Applicazione	`Machine.ReadWrite.All`	`Read and write all machine information`
Delegato (account aziendale o dell'istituto di istruzione)	`Machine.Read`	`Read machine information`
Delegato (account aziendale o dell'istituto di istruzione)	`Machine.ReadWrite`	`Read and write machine information`

Nota

Quando si ottiene un token usando le credenziali utente:

L'utente deve disporre almeno dell'autorizzazione del ruolo seguente: View Data. Per altre informazioni, vedere Creare e gestire ruoli.
Le risposte includono solo i dispositivi a cui l'utente può accedere, in base alle impostazioni del gruppo di dispositivi. Per altre informazioni, vedere Creare e gestire gruppi di dispositivi. La creazione di gruppi di dispositivi è supportata in Defender per endpoint Piano 1 e Piano 2.

Richiesta HTTP

GET /api/domains/{domain}/machines

Intestazioni di richiesta

Nome	Tipo	Descrizione
Autorizzazione	Stringa	`Bearer {token}`. Obbligatorio.

Corpo della richiesta

Vuoto

Risposta

In caso di esito positivo e il dominio esiste:

200 OK con elenco di entità del computer

Se il dominio non esiste:

200 OK con un set vuoto

Esempio

Richiesta

Ecco un esempio della richiesta.

GET https://api.securitycenter.microsoft.com/api/domains/api.securitycenter.microsoft.com/machines