Uppdatera dator

  • Gäller för: Microsoft Defender for Endpoint Plan 1, Microsoft Defender for Endpoint Plan 2, Microsoft Defender for Business

API-beskrivning

Uppdateringar egenskaper för befintlig dator.

Uppdateringsbara egenskaper är: machineTags och deviceValue.

Begränsningar

  • Du kan uppdatera datorer som är tillgängliga i API:et.
  • Uppdatera datorn lägger bara till taggar i taggsamlingen. Om det finns taggar måste de inkluderas i samlingen taggar i brödtexten.
  • 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: "Undersökning av aviseringar". Mer information finns i: Skapa och hantera roller.
  • Användaren måste ha åtkomst till den enhet som är associerad med aviseringen, baserat på enhetsgruppsinställningarna. Mer information finns i: Skapa och hantera enhetsgrupper.

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 Microsoft Defender för Endpoint-API:er

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

HTTP-begäran

PATCH /api/machines/{machineId}

Frågerubriker

Namn Typ Beskrivning
Behörighet Sträng Ägaren {token}. Krävs.
Content-Type Sträng application/json. Krävs.

Frågebrödtext

Ange värdena för de relevanta fält som ska uppdateras i begärandetexten.

Befintliga egenskaper som inte ingår i begärandetexten behåller sina tidigare värden eller beräknas om baserat på ändringar i andra egenskapsvärden.

För bästa prestanda bör du inte inkludera befintliga värden som inte har ändrats.

Egenskap Typ Beskrivning
machineTags Strängsamling Uppsättning med datortaggar .
deviceValue Uppräkning som kan ha värdet Null Enhetens värde. Möjliga värden är: "Normal", "Low" och "High".

Svar

Om det lyckas returnerar den här metoden 200 OK och datorentiteten i svarstexten med de uppdaterade egenskaperna.

Om samlingen med datortaggar i brödtexten inte innehåller befintliga datortaggar ersätter alla taggar med taggarna som anges i begärandetexten.

Om datorn med det angivna ID:t inte hittades – 404 Hittades inte.

Exempel

Begäran

Här är ett exempel på begäran.

PATCH https://api.security.microsoft.com/api/machines/{machineId}

{
    "deviceValue": "Normal",
    "machineTags": [
                     "Demo Device",
                     "Generic User Machine - Attack Source",
                     "Windows 10" "Windows11",
                     "Windows Insider - Fast"
    ]
}
  • Last updated on