Del via

Legge til eller fjerne et merke for flere maskiner

  • Artikkel

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

API-beskrivelse

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

Begrensninger

  1. Du kan legge ut på maskiner som sist ble sett i henhold til konfigurert oppbevaringsperiode.
  2. Satsbegrensninger for denne API-en er 100 oppkall per minutt og 1500 anrop per time.
  3. 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:

HTTP-forespørsel

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

Forespørselshoder

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

Forespørselstekst

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

Parameteren Type: Beskrivelse
Verdi Streng Kodenavnet. Obligatorisk.
Handling Enum Legg til eller fjern. Tillatte verdier er: Legg til eller Fjern. Obligatorisk.
MachineIds Liste (streng) Liste over maskin-ID-er som skal oppdateres. Nødvendig.

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.

Tips

Vil du lære mer? Engage med Microsoft Security-fellesskapet i teknisk fellesskap: Microsoft Defender for endepunkt teknisk fellesskap.