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

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

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.

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"

HTTP-begäran

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

Tips

För bättre prestanda, i stället för att använda api.security.microsoft.com, använder du en server som är närmare 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
• aea.api.security.microsoft.com

Frågerubriker

Namn	Typ	Beskrivning
Behörighet	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.
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

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.

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

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

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