Muistiinpano
Tämän sivun käyttö edellyttää valtuutusta. Voit yrittää kirjautua sisään tai vaihtaa hakemistoa.
Tämän sivun käyttö edellyttää valtuutusta. Voit yrittää vaihtaa hakemistoa.
Ohjelmointirajapinnan kuvaus
Kumoa laitteen eristäminen.
Kun laite eristetään, vain tietyt prosessit ja kohteet sallitaan. Laitteet, jotka ovat täyden VPN-tunnelin takana, eivät pääse Microsoft Defender for Endpoint pilvipalveluun laitteen eristämisen jälkeen. Suosittelemme, että käytät jaettua tunnelointi-VPN:ää Microsoft Defender for Endpoint ja Microsoft Defender virustentorjuntaan pilvipohjaisessa suojaukseen liittyvässä liikenteessä.
Rajoitukset
Tämän ohjelmointirajapinnan nopeusrajoitukset ovat 100 puhelua minuutissa ja 1 500 puhelua tunnissa.
Ennakkovaatimukset
Tuetut käyttöjärjestelmät
- Täysi eristys on käytettävissä laitteissa, Windows 10 versiossa 1703.
- Täysi eristys on käytettävissä julkisessa esikatselussa kaikille tuetuille Microsoft Defender for Endpoint järjestelmävaatimuksissa luetelluissa Linux.
- Valikoiva eristys on käytettävissä laitteissa, Windows 10 versiossa 1709 tai uudemmassa.
Käyttöoikeudet
Kun hankit tunnuksen käyttäjän tunnistetiedoilla:
- Käyttäjällä on oltava vähintään seuraava roolioikeus: Aktiiviset korjaustoiminnot. Lisätietoja on ohjeaiheessa Roolien luominen ja hallinta.
- Käyttäjällä on oltava laitteen käyttöoikeus laiteryhmän asetusten perusteella. Lisätietoja on kohdassa Laiteryhmien luominen ja hallinta.
Tämän ohjelmointirajapinnan kutsumiseen tarvitaan jokin seuraavista käyttöoikeuksista. Lisätietoja ja käyttöoikeuksien valitseminen on artikkelissa Microsoft Defender for Endpoint ohjelmointirajapintoja
| Käyttöoikeustyyppi | Lupaa | Käyttöoikeuden näyttönimi |
|---|---|---|
| Sovellus | Kone.Eristää | 'Eristä kone' |
| Delegoitu (työpaikan tai oppilaitoksen tili) | Kone.Eristää | 'Eristä kone' |
HTTP-pyyntö
POST https://api.security.microsoft.com/api/machines/{id}/unisolate
Pyynnön otsikot
| Nimi | Kirjoita | Kuvaus |
|---|---|---|
| Lupa | Merkkijono | Haltija {token}. Pakollinen. |
| Sisältötyyppi | Merkkijono | application/json. Pakollinen. |
Pyynnön leipäteksti
Anna pyynnön leipätekstissä JSON-objekti, jolla on seuraavat parametrit:
| Parametri | Kirjoita | Kuvaus |
|---|---|---|
| Kommentoi | Merkkijono | Toimintoon liitettävä kommentti. Pakollinen. |
Vastaus
Jos tämä menetelmä onnistuu, se palauttaa arvon 201 – Luotu vastauskoodi ja konetoiminto vastauksen leipätekstissä.
Jos lähetät useita ohjelmointirajapintakutsuja saman laitteen eristyksen poistamiseksi, se palauttaa "odottavan koneen toiminnon" tai HTTP 400:n, jossa on viesti "Toiminto on jo käynnissä".
Esimerkki
Pyyntö
Tässä on esimerkki pyynnöstä.
POST https://api.security.microsoft.com/api/machines/1e5bc9d7e413ddd7902c2932e418702b84d0cc07/unisolate
{
"Comment": "Unisolate machine since it was clean and validated"
}