Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
API-beskrivning
Lägger till eller tar bort en tagg för en specifik enhet.
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
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/{id}/tags
Frågerubriker
| Namn | Typ | Beskrivning |
|---|---|---|
| Behörighet | Sträng | Ägaren {token}. Krävs. |
| Content-Type | sträng | application/json. Krävs. |
Frågebrödtext
Om du vill ta bort datortaggen anger du Åtgärden till Ta bort i stället för Lägg till i begärandetexten.
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.security.microsoft.com/api/machines/1e5bc9d7e413ddd7902c2932e418702b84d0cc07/tags
{
"Value" : "test Tag 2",
"Action": "Add"
}