Uppdatera dator

Artikel
05/03/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

Uppdaterar 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

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

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"

Obs!

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.

Skapande av enhetsgrupp stöds i Defender för Endpoint Plan 1 och Plan 2.

HTTP-begäran

PATCH /api/machines/{machineId}

Frågerubriker

Namn	Typ	Beskrivning
Tillstånd	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.securitycenter.microsoft.com/api/machines/{machineId}

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