Impostare l'API del valore del dispositivo
Si applica a:
- Microsoft Defender per endpoint Piano 1
- Microsoft Defender per endpoint Piano 2
- Microsoft Defender XDR
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
Impostare il valore del dispositivo di un computer specifico.
Per altre informazioni , vedere Assegnare i valori dei dispositivi .
Limitazioni
- È possibile pubblicare nei dispositivi visualizzati per l'ultima volta in base al periodo di conservazione configurato.
- Le limitazioni di frequenza per questa API sono 100 chiamate al minuto e 1500 chiamate all'ora.
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.ReadWrite.All | 'Leggere e scrivere tutte le informazioni del computer' |
| Delegato (account aziendale o dell'istituto di istruzione) | Machine.ReadWrite | 'Leggere e scrivere informazioni sulla macchina' |
Nota
Quando si ottiene un token usando le credenziali utente:
- L'utente deve disporre almeno dell'autorizzazione del ruolo seguente: "Gestisci impostazione di sicurezza". Per altre informazioni, vedere Creare e gestire ruoli .
- L'utente deve avere accesso al computer in base alle impostazioni del gruppo di computer (vedere Creare e gestire gruppi di computer per altre informazioni)
Richiesta HTTP
POST https://api.security.microsoft.com/api/machines/{machineId}/setDeviceValue
Intestazioni di richiesta
| Nome | Tipo | Descrizione |
|---|---|---|
| Autorizzazione | Stringa | Bearer {token}. Obbligatorio. |
| Content-Type | stringa | application/json. Obbligatorio. |
Corpo della richiesta
Nel corpo della richiesta specificare un oggetto JSON con i parametri seguenti:
| Parametro | Tipo | Descrizione |
|---|---|---|
| DeviceValue | Enumerazione | Valore del dispositivo. I valori consentiti sono: 'Normal', 'Low' e 'High'. Obbligatorio. |
Risposta
In caso di esito positivo, questo metodo restituisce il codice di risposta 200 - Ok e il computer aggiornato nel corpo della risposta.
Esempio
Richiesta
Di seguito è riportato un esempio di richiesta che aggiunge il tag del computer.
POST https://api.security.microsoft.com/api/machines/1e5bc9d7e413ddd7902c2932e418702b84d0cc07/setDeviceValue
{
"DeviceValue" : "High"
}
Consiglio
Per saperne di più, Collaborare con la community di Microsoft Security nella community tech: Microsoft Defender per endpoint Tech Community.