Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Descrizione DELL'API
Annullare l'isolamento di un dispositivo.
Quando si isola un dispositivo, sono consentiti solo determinati processi e destinazioni. I dispositivi che si trovano dietro un tunnel VPN completo non saranno in grado di raggiungere il servizio cloud Microsoft Defender per endpoint dopo l'isolamento del dispositivo. È consigliabile usare una VPN di split tunneling per Microsoft Defender per endpoint e Microsoft Defender traffico correlato alla protezione basata sul cloud antivirus.
Limitazioni
Le limitazioni di frequenza per questa API sono 100 chiamate al minuto e 1500 chiamate all'ora.
Prerequisiti
Sistemi operativi supportati
- L'isolamento completo è disponibile per i dispositivi in Windows 10 versione 1703.
- L'isolamento completo è disponibile in anteprima pubblica per tutti i Microsoft Defender per endpoint supportati in Linux elencati in Requisiti di sistema.
- L'isolamento selettivo è disponibile per i dispositivi in Windows 10 versione 1709 o successiva.
Autorizzazioni
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. Per altre informazioni, vedere : Creare e gestire gruppi di dispositivi.
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.Isolate | 'Isola macchina' |
| Delegato (account aziendale o dell'istituto di istruzione) | Machine.Isolate | 'Isola macchina' |
Richiesta HTTP
POST https://api.security.microsoft.com/api/machines/{id}/unisolate
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 |
|---|---|---|
| Comment | Stringa | Commento da associare all'azione. Obbligatorio. |
Risposta
In caso di esito positivo, questo metodo restituisce 201 - Codice di risposta creato e Azione computer nel corpo della risposta.
Se si inviano più chiamate API per rimuovere l'isolamento per lo stesso dispositivo, restituisce "azione 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/unisolate
{
"Comment": "Unisolate machine since it was clean and validated"
}