Del via

Tilføj eller fjern et mærke for flere maskiner

  • Gælder for: Microsoft Defender for Endpoint, Microsoft Defender for Endpoint Plan 1

API-beskrivelse

Tilføjer eller fjerner en kode for det angivne sæt computere.

Begrænsninger

  • Du kan postere på maskiner, der sidst vises i henhold til din konfigurerede opbevaringsperiode.
  • Hastighedsbegrænsninger for denne API er 100 opkald pr. minut og 1.500 opkald pr. time.
  • Vi kan tilføje eller fjerne et mærke for op til 500 maskiner pr. API-kald.

Tilladelser

Når du henter et token ved hjælp af brugerlegitimationsoplysninger:

  • Brugeren skal som minimum have følgende rolletilladelse: 'Administrer sikkerhedsindstilling'. Du kan få flere oplysninger under: Opret og administrer roller.
  • Brugeren skal have adgang til computeren baseret på computergruppeindstillinger. Du kan få flere oplysninger under: Opret og administrer computergrupper.

En af følgende tilladelser er påkrævet for at kalde denne API. Hvis du vil vide mere, herunder hvordan du vælger tilladelser, skal du se Brug Defender til Slutpunkt-API'er.

Tilladelsestype Tilladelse Vist navn for tilladelse
Program Machine.ReadWrite.All 'Læs og skriv alle computeroplysninger'
Uddelegeret (arbejds- eller skolekonto) Machine.ReadWrite 'Læs og skriv computeroplysninger'

HTTP-anmodning

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

Tip

Hvis du vil opnå en bedre ydeevne, skal du i stedet for at bruge api.security.microsoft.com bruge en server, der er tættere på din geoplacering:

  • 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
  • aea.api.security.microsoft.com

Anmodningsheadere

Navn Type Beskrivelse
Tilladelse String Ihændehaver {token}. Påkrævet.
Indholdstype Streng application/json. Påkrævet.

Brødtekst i anmodning

Angiv følgende parametre for et JSON-objekt i anmodningens brødtekst:

Parameter Type Beskrivelse
Værdi String Kodenavnet. Påkrævet.
Handling Enum Tilføj eller fjern. Tilladte værdier er: 'Add' eller 'Remove'. Påkrævet.
Computer-id'er Liste (streng) Liste over computer-id'er, der skal opdateres. Kræves.

Svar

Hvis det lykkes, returnerer denne metode 200 – Ok-svarkode og de opdaterede maskiner i svarbrødteksten.

Eksempelanmodning

Hvis du vil fjerne computerkoder, skal du angive Handlingen til 'Fjern' i stedet for 'Tilføj' i anmodningens brødtekst.

Her er et eksempel på en anmodning, der føjer et mærke til flere computere.

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

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