Legge til eller fjerne en kode for en maskin
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 Endpoint 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 en bestemt enhet.
Obs!
Hvis du leter etter hvordan du merker maskiner i bulk via API, kan du se Legge til eller fjerne flere maskinkoder.
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.
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 (se Opprette og behandle roller for mer informasjon).
- 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/{id}/tags
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. |
Svar
Hvis dette lykkes, returnerer denne metoden 200 – OK-svarkode og den oppdaterte maskinen i svarteksten.
Eksempelforespørsel
Her er et eksempel på en forespørsel som legger til et maskinmerke.
POST https://api.securitycenter.microsoft.com/api/machines/1e5bc9d7e413ddd7902c2932e418702b84d0cc07/tags
{
"Value" : "test Tag 2",
"Action": "Add"
}
Hvis du vil fjerne maskinkode, setter du handlingen til Fjern i stedet for Legg til i forespørselsteksten.
Tips
Vil du lære mer? Engasjer deg med Microsoft Security-fellesskapet i det tekniske fellesskapet vårt: Microsoft Defender for Endpoint Tech Community.