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


Kötegtörlés mutatói

Érintett szolgáltatás:

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" ]
}