Lägga till eller ta bort en tagg för en dator
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 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
Du kan publicera på datorer som senast visas enligt din konfigurerade kvarhållningsperiod.
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:
- 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/{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 | Räkna upp | 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? Interagera med Microsoft Security-communityn i vår Tech Community: Microsoft Defender för Endpoint Tech Community.