Lägga till eller ta bort en tagg för en dator

  • Artikel

Gäller för:

Vill du uppleva Microsoft Defender för Endpoint? Registrera dig för en kostnadsfri utvärderingsversion.

Obs!

Om du är en us government-kund använder du de URI:er som anges i Microsoft Defender för Endpoint för amerikanska myndighetskunder.

Tips

För bättre prestanda kan du använda servern närmare din geoplats:

  • 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

API-beskrivning

Lägger till eller tar bort en tagg för en specifik enhet.

Obs!

Om du letar efter hur du taggar datorer i grupp via API kan du läsa Lägga till eller ta bort flera datortaggar.

Begränsningar

  1. Du kan publicera på datorer som senast visas enligt din konfigurerade kvarhållningsperiod.

  2. Hastighetsbegränsningar för det här API:et är 100 anrop per minut och 1 500 anrop per timme.

Behörigheter

En av följande behörigheter krävs för att anropa det här API:et. Mer information, inklusive hur du väljer behörigheter, finns i Använda Defender för Endpoint-API:er.

Behörighetstyp Behörighet Visningsnamn för behörighet
Program Machine.ReadWrite.All "Läsa och skriva all datorinformation"
Delegerat (arbets- eller skolkonto) Machine.ReadWrite "Läsa och skriva datorinformation"

Obs!

När du hämtar en token med användarautentiseringsuppgifter:

HTTP-begäran

POST https://api.securitycenter.microsoft.com/api/machines/{id}/tags

Frågerubriker

Namn Typ Beskrivning
Tillstånd Sträng Ägaren {token}. Krävs.
Content-Type sträng application/json. Krävs.

Frågebrödtext

I begärandetexten anger du ett JSON-objekt med följande parametrar:

Parameter Typ Beskrivning
Värde Sträng Taggnamnet. Krävs.
Åtgärd Enum Lägg till eller ta bort. Tillåtna värden är: "Lägg till" eller "Ta bort". Krävs.

Svar

Om det lyckas returnerar den här metoden svarskoden 200 – Ok och den uppdaterade datorn i svarstexten.

Exempelbegäran

Här är ett exempel på en begäran som lägger till en datortagg.

POST https://api.securitycenter.microsoft.com/api/machines/1e5bc9d7e413ddd7902c2932e418702b84d0cc07/tags

{
  "Value" : "test Tag 2",
  "Action": "Add"
}

Om du vill ta bort datortaggen anger du Åtgärden till Ta bort i stället för Lägg till i begärandetexten.

Tips

Vill du veta mer? Engage med Microsofts säkerhetscommunity i vår Tech Community: Microsoft Defender för Endpoint Tech Community.