Megosztás a következőn keresztül:

Eszköz felszabadítása az elkülönítési API-ból

  • Cikk

Érintett szolgáltatás:

Szeretné megismerni a Végponthoz készült Microsoft Defendert? Regisztráció az ingyenes próbaverzióra

Megjegyzés:

Ha Ön az USA kormányzati szerveinek ügyfele, használja az USA kormányzati ügyfeleinek készült Végponthoz készült Microsoft Defenderben felsorolt URI-kat.

Tipp

A jobb teljesítmény érdekében a földrajzi helyhez közelebbi kiszolgálót használhat:

  • 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

API-leírás

Eszköz elkülönítésének visszavonása.

Korlátozások

  1. Az API sebességkorlátozásai percenként 100 hívás és óránként 1500 hívás.

Megjegyzés:

Ez az oldal a gépi műveletek API-n keresztüli végrehajtására összpontosít. A végponthoz készült Microsoft Defenderen keresztüli válaszműveletekkel kapcsolatos további információkért lásd: Válaszműveletek végrehajtása egy gépen .

Fontos

  • Teljes elkülönítés érhető el a Windows 10 1703-es verziójában futó eszközökön.
  • A teljes elkülönítés nyilvános előzetes verzióban érhető el a Rendszerkövetelmények szakaszban felsorolt összes támogatott Végponthoz készült Végponthoz készült Microsoft Defenderhez.
  • A szelektív elkülönítés a Windows 10 1709-es vagy újabb verziójában elérhető.
  • Az eszközök elkülönítésekor csak bizonyos folyamatok és célhelyek engedélyezettek. Ezért a teljes VPN-alagút mögött található eszközök nem fogják tudni elérni a Végponthoz készült Microsoft Defender felhőszolgáltatást az eszköz elkülönítése után. Javasoljuk, hogy használjon osztott bújtatású VPN-t a Végponthoz készült Microsoft Defenderhez és a Microsoft Defender víruskereső felhőalapú védelemmel kapcsolatos forgalmához.

Engedélyek

Az API meghívásához az alábbi engedélyek egyikére van szükség. További információ, beleértve az engedélyek kiválasztását: Végponthoz készült Microsoft Defender API-k használata

Engedély típusa Engedély Engedély megjelenítendő neve
Alkalmazás Machine.Isolate "Gép elkülönítése"
Delegált (munkahelyi vagy iskolai fiók) Machine.Isolate "Gép elkülönítése"

Megjegyzés:

Jogkivonat felhasználói hitelesítő adatokkal történő beszerzésekor:

Az eszközcsoport létrehozása a Végponthoz készült Defender 1. és 2. csomagjában támogatott.

HTTP-kérés

POST https://api.security.microsoft.com/api/machines/{id}/unisolate

Kérelemfejlécek

Name (Név) Típus Leírás
Felhatalmazás Karakterlánc Tulajdonos : {token}. Kötelező megadni.
Tartalomtípus sztring application/json. Kötelező megadni.

Kérelem törzse

A kérelem törzsében adjon meg egy JSON-objektumot a következő paraméterekkel:

Paraméter Típus Leírás
Megjegyzés Karakterlánc A művelethez társítandó megjegyzés. Kötelező megadni.

Válasz

Ha sikeres, ez a metódus a 201 – Létrehozott válaszkódot és a Gépi műveletet adja vissza a válasz törzsében.

Ha több API-hívást küld ugyanahhoz az eszközhöz az elkülönítés eltávolításához, az "függőben lévő gépi művelet" vagy HTTP 400 értéket ad vissza a "Művelet már folyamatban" üzenettel.

Példa

Kérés

Íme egy példa a kérésre.

POST https://api.security.microsoft.com/api/machines/1e5bc9d7e413ddd7902c2932e418702b84d0cc07/unisolate 

{
  "Comment": "Unisolate machine since it was clean and validated"
}

Az eszközök elkülönítéséhez lásd: Eszköz elkülönítése.

Tipp

Szeretne többet megtudni? Vegye fel a kapcsolatot a Microsoft Security közösségével a technikai közösségünkben: Microsoft Defender for Endpoint Tech Community.