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

Artikel
08/14/2024

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
ina.api.security.microsoft.com

API-beskrivning

Lägger till eller tar bort en tagg för den angivna uppsättningen datorer.

Begränsningar

Du kan publicera på datorer som senast visas enligt din konfigurerade kvarhållningsperiod.
Frekvensbegränsningar för det här API:et är 100 anrop per minut och 1 500 anrop per timme.
Vi kan lägga till eller ta bort en tagg för upp till 500 datorer per API-anrop.

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:

Användaren måste ha minst följande rollbehörighet: "Hantera säkerhetsinställning". Mer information finns i Skapa och hantera roller.
Användaren måste ha åtkomst till datorn baserat på datorgruppsinställningarna (mer information finns i Skapa och hantera datorgrupper ).

HTTP-begäran

POST https://api.securitycenter.microsoft.com/api/machines/AddOrRemoveTagForMultipleMachines

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	Räkna upp	Lägg till eller ta bort. Tillåtna värden är: "Lägg till" eller "Ta bort". Krävs.
MachineIds	Lista (sträng)	Lista över dator-ID:t som ska uppdateras. Obligatoriskt.

Svar

Om det lyckas returnerar den här metoden 200 – OK svarskod och de uppdaterade datorerna i svarstexten.

Exempelbegäran

Här är ett exempel på en begäran som lägger till en tagg till flera datorer.

POST https://api.securitycenter.microsoft.com/api/machines/AddOrRemoveTagForMultipleMachines

{
  "Value" : "Tag",
  "Action": "Add",
  "MachineIds": ["34e83ca3feea4dae2353006ba389262c033a025e",
  "2a398439b4975924e87a65943972bc702469b329",
  "a610c00c65fdf79960cc0077d9d8c569d23f09a5"]
}

Om du vill ta bort datortaggar ställer du in åtgärden på Ta bort i stället för Lägg till i begärandetexten.