Oppdater maskin

API-beskrivelse

Oppdateringer egenskaper for eksisterende maskin.

Egenskaper som kan oppdateres, er: machineTags og deviceValue.

Begrensninger

• Du kan oppdatere maskiner som er tilgjengelige i API-en.
• Oppdater maskinen tilføyer bare koder i kodesamlingen. Hvis det finnes koder, må de inkluderes i kodesamlingen i brødteksten.
• Satsbegrensninger for denne API-en er 100 oppkall per minutt og 1500 anrop per time.

Tillatelser

Når du skaffer et token ved hjelp av brukerlegitimasjon:

• Brukeren må minst ha følgende rolletillatelse: «Varsler undersøkelse». Hvis du vil ha mer informasjon, kan du se: Opprette og administrere roller.
• Brukeren må ha tilgang til enheten som er knyttet til varselet, basert på innstillingene for enhetsgruppen. Hvis du vil ha mer informasjon, kan du se: Opprette og administrere enhetsgrupper.

Én av følgende tillatelser er nødvendig for å kalle opp denne API-en. Hvis du vil ha mer informasjon, inkludert hvordan du velger tillatelser, kan du se: Bruke Microsoft Defender for endepunkt API-er

Tillatelsestype	Tillatelse	Visningsnavn for tillatelse
Program	Machine.ReadWrite.All	«Les og skriv maskininformasjon for alle maskiner»
Delegert (jobb- eller skolekonto)	Machine.ReadWrite	Les og skriv maskininformasjon

HTTP-forespørsel

PATCH /api/machines/{machineId}

Forespørselshoder

Navn	Type:	Beskrivelse
Authorization	Streng	Bærer {token}. Obligatorisk.
Innholdstype	Streng	program/json. Obligatorisk.

Forespørselstekst

Angi verdiene for de relevante feltene som skal oppdateres, i forespørselsteksten.

Eksisterende egenskaper som ikke er inkludert i forespørselsteksten, opprettholder de tidligere verdiene eller beregnes på nytt basert på endringer i andre egenskapsverdier.

For best ytelse bør du ikke inkludere eksisterende verdier som ikke har blitt endret.

Egenskapen	Type:	Beskrivelse
machineTags	Strengsamling	Sett med maskinkoder .
deviceValue	Opplisting som kan nullstilles	Verdien til enheten. Mulige verdier er: Normal, Lav og Høy.

Svar

Hvis dette lykkes, returnerer denne metoden 200 OK, og maskinenheten i svarteksten med de oppdaterte egenskapene.

Hvis maskinkodesamlingen i brødteksten ikke inneholder eksisterende maskinkoder , erstattes alle koder med kodene som er angitt i brødteksten for forespørselen.

Hvis maskinen med den angitte ID-en ikke ble funnet – finner du ikke 404.

Eksempel

Forespørsel

Her er et eksempel på forespørselen.

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"
    ]
}