Eseguire l'API di analisi antivirus
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
Avviare l'analisi di Microsoft Defender Antivirus in un dispositivo.
Limitazioni
- Le limitazioni di frequenza per questa API sono 100 chiamate al minuto e 1500 chiamate all'ora.
Nota
Questa pagina è incentrata sull'esecuzione di un'azione del computer tramite l'API. Per altre informazioni sulla funzionalità delle azioni di risposta tramite Microsoft Defender per endpoint, vedere Eseguire azioni di risposta in un computer .
Importante
- Questa azione è disponibile per i dispositivi in Windows 10, versione 1709 o successiva e in Windows 11.
- Un'analisi di Microsoft Defender Antivirus può essere eseguita insieme ad altre soluzioni antivirus, indipendentemente dal fatto che Microsoft Defender Antivirus sia o meno la soluzione antivirus attiva. Microsoft Defender Antivirus può essere in modalità passiva. Per altre informazioni, vedere Compatibilità di Microsoft Defender Antivirus.
Autorizzazioni
Per chiamare questa API è necessaria una delle autorizzazioni seguenti. Per altre informazioni, incluso come scegliere le autorizzazioni, vedere Usare le API di Microsoft Defender per endpoint
| Tipo di autorizzazione | Autorizzazione | Nome visualizzato autorizzazioni |
|---|---|---|
| Applicazione | Machine.Scan | 'Scan machine' |
| Delegato (account aziendale o dell'istituto di istruzione) | Machine.Scan | 'Scan machine' |
Nota
Quando si ottiene un token usando le credenziali utente:
- L'utente deve disporre almeno dell'autorizzazione del ruolo seguente: "Azioni di correzione attive" (per altre informazioni, vedere Creare e gestire ruoli )
- L'utente deve avere accesso al dispositivo in base alle impostazioni del gruppo di dispositivi (vedere Creare e gestire gruppi di dispositivi per altre informazioni)
La creazione di gruppi di dispositivi è supportata in Defender per endpoint Piano 1 e Piano 2.
Richiesta HTTP
POST https://api.security.microsoft.com/api/machines/{id}/runAntiVirusScan
Intestazioni di richiesta
| Nome | Tipo | Descrizione |
|---|---|---|
| Autorizzazione | Stringa | Bearer {token}. Obbligatorio. |
| Content-Type | stringa | application/json |
Corpo della richiesta
Nel corpo della richiesta specificare un oggetto JSON con i parametri seguenti:
| Parametro | Tipo | Descrizione |
|---|---|---|
| Comment | Stringa | Commento da associare all'azione. Obbligatorio. |
| ScanType | Stringa | Definisce il tipo di analisi. Obbligatorio. |
ScanType controlla il tipo di analisi da eseguire e può essere uno dei seguenti:
- Veloce: eseguire un'analisi rapida nel dispositivo
- Completa: eseguire l'analisi completa nel dispositivo
Risposta
In caso di esito positivo, questo metodo restituisce 201, Codice di risposta creato e oggetto MachineAction nel corpo della risposta.
Se si inviano più chiamate API per eseguire un'analisi antivirus per lo stesso dispositivo, restituisce "azione del computer in sospeso" o HTTP 400 con il messaggio "L'azione è già in corso".
Esempio
Richiesta
Di seguito è riportato un esempio della richiesta.
POST https://api.security.microsoft.com/api/machines/1e5bc9d7e413ddd7902c2932e418702b84d0cc07/runAntiVirusScan
{
"Comment": "Check machine for viruses due to alert 3212",
"ScanType": "Full"
}
Consiglio
Per saperne di più, Collaborare con la community di Microsoft Security nella community tech: Microsoft Defender per endpoint Tech Community.