Legge til eller fjerne et merke for flere maskiner

Artikkel
02/20/2025

Gjelder for:

Vil du oppleve Microsoft Defender for endepunkt? Registrer deg for en gratis prøveperiode.

Obs!

Hvis du er us Government-kunde, kan du bruke URI-ene som er oppført i Microsoft Defender for endepunkt for US Government-kunder.

Tips

Hvis du vil ha bedre ytelse, kan du bruke serveren nærmere geografisk plassering:

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-beskrivelse

Legger til eller fjerner en kode for det angitte settet med maskiner.

Begrensninger

Du kan legge ut på maskiner som sist ble sett i henhold til konfigurert oppbevaringsperiode.
Satsbegrensninger for denne API-en er 100 oppkall per minutt og 1500 anrop per time.
Vi kan legge til eller fjerne en kode for opptil 500 maskiner per API-kall.

Tillatelser

É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 Defender for endepunkt-API-er.

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

Obs!

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

Brukeren må minst ha følgende rolletillatelse: Administrer sikkerhetsinnstilling. Hvis du vil ha mer informasjon, kan du se Opprette og administrere roller.
Brukeren må ha tilgang til maskinen, basert på maskingruppeinnstillinger (se Opprette og administrere maskingrupper for mer informasjon).

HTTP-forespørsel

POST https://api.securitycenter.microsoft.com/api/machines/AddOrRemoveTagForMultipleMachines

Forespørselshoder

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

Forespørselstekst

Angi et JSON-objekt med følgende parametere i forespørselsteksten:

Parameter	Type:	Beskrivelse
Verdi	Streng	Kodenavnet. Obligatorisk.
Handling	Opplisting	Legg til eller fjern. Tillatte verdier er: Legg til eller Fjern. Obligatorisk.
MachineIds	Liste (streng)	Liste over maskin-ID-er som skal oppdateres. Påkrevd.

Svar

Hvis dette lykkes, returnerer denne metoden 200 – OK-svarkode og de oppdaterte maskinene i svarteksten.

Eksempelforespørsel

Her er et eksempel på en forespørsel som legger til en kode på flere maskiner.

POST https://api.securitycenter.microsoft.com/api/machines/AddOrRemoveTagForMultipleMachines

{
  "Value" : "Tag",
  "Action": "Add",
  "MachineIds": ["34e83ca3feea4dae2353006ba389262c033a025e",
  "2a398439b4975924e87a65943972bc702469b329",
  "a610c00c65fdf79960cc0077d9d8c569d23f09a5"]
}

Hvis du vil fjerne maskinkoder, setter du handlingen til Fjern i stedet for Legg til i forespørselsteksten.