Uppdatera dator

Gäller för:

Vill du uppleva Microsoft Defender för Endpoint? Registrera dig för en kostnadsfri utvärderingsversion.

Anteckning

Om du är myndighetskund i USA kan du använda de URI:er som visas i Microsoft Defender för Slutpunkt för kunder inom myndigheter i USA.

Tips

För bättre prestanda kan du använda servern närmare din geografiska plats:

  • api-us.securitycenter.microsoft.com
  • api-eu.securitycenter.microsoft.com
  • api-uk.securitycenter.microsoft.com

API-beskrivning

Uppdaterar egenskaper för befintlig dator.

Egenskaper som kan uppdateras är: machineTags och deviceValue .

Begränsningar

  1. Du kan uppdatera datorer som finns tillgängliga i API:et.
  2. Update machine lägger bara till taggar i taggsamlingen. Om det finns taggar måste de inkluderas i taggsamlingen i brödtexten.
  3. Prisbegränsningar för detta API är 100 samtal per minut och 1 500 samtal per timme.

Behörigheter

En av följande behörigheter krävs för att anropa detta API. Mer information, inklusive hur du väljer behörigheter, finns i Använda Microsoft Defender för slutpunkts-API:er

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

Anteckning

När du skaffar en token med hjälp av 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 enheten som är kopplad till aviseringen, baserat på enhetens gruppinställningar. Mer information finns i Skapa och hantera enhetsgrupper.

HTTP-begäran

PATCH /api/machines/{machineId}

Frågerubriker

Namn Typ Beskrivning
Auktorisering Sträng Bearer {token}. Obligatoriskt.
Content-Type Sträng application/json. Obligatoriskt.

Frågebrödtext

Ange värden för de relevanta fält som ska uppdateras i begärans brödtext.

Befintliga egenskaper som inte ingår i begärans brödtext behåller sina tidigare värden eller beräknas om baserat på ändringar av 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 maskintaggar.
deviceValue Nullbar uppräkning Enhetens värde. Möjliga värden är: "Normal", "Låg" och "Hög".

Svar

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

Om insamling av maskintaggar i brödtexten inte innehåller befintliga maskintaggar ersätter du alla taggar med de taggar som finns i begärans brödtext.

Om ingen dator med det angivna ID:t 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"
    ]
}