Kötegtörlés mutatói
Érintett szolgáltatás:
- Végponthoz készült Microsoft Defender 1. csomag
- Végponthoz készült Microsoft Defender
- Microsoft Defender XDR
Szeretné megismerni a Végponthoz készült Defendert? Regisztráció az ingyenes próbaverzióra
Megjegyzés:
Ha Ön az USA kormányzati szerveinek ügyfele, használja a Végponthoz készült Microsoft Defender-ben felsorolt URI-kat az USA kormányzati ügyfelei számára.
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
Azonosító alapján törli a mutatóentitásokat.
Korlátozások
Az API sebességkorlátozásai percenként 30 hívás és óránként 1500 hívás.
A köteg méretkorlátja legfeljebb 500 mutatóazonosító .
Engedélyek
Az API meghívásához az alábbi engedélyek egyikére van szükség. További információkért, beleértve az engedélyek kiválasztását is, olvassa el az Első lépések című témakört.
Engedély típusa | Engedély | Engedély megjelenítendő neve |
---|---|---|
Alkalmazás | Ti.ReadWrite | "TI-mutatók olvasása és írása" |
Alkalmazás | Ti.ReadWrite.All | "Olvasási és írási mutatók" |
HTTP-kérés
POST https://api.securitycenter.microsoft.com/api/indicators/BatchDelete
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
Kérelemfejlécek
Name (Név) | Típus | Leírás |
---|---|---|
Felhatalmazás | Karakterlánc | Tulajdonos : {token}. 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 |
---|---|---|
Mutatóazonosítók | Listasztring | Az eltávolítandó mutatók azonosítóinak listája. Kötelező |
Válasz
Ha az összes mutató létezik, és sikeresen törölve lett - 204 OK tartalom nélkül.
Ha a mutatóazonosítók listája üres vagy meghaladja a méretkorlátot – 400 – Hibás kérés.
Ha bármely mutatóazonosító érvénytelen – 400 Hibás kérés.
Ha a kérelmező nincs kitéve egyetlen mutató eszközcsoportjának sem – 403 Tiltott.
Ha nem található mutatóazonosító – 404 Nem található.
Példa
Kérés
Íme egy példa a kérésre.
POST https://api.securitycenter.microsoft.com/api/indicators/BatchDelete
{
"IndicatorIds": [ "1", "2", "5" ]
}