Få beskedoplysninger efter ID-API

API-beskrivelse

Henter en bestemt besked ved hjælp af id'et.

Begrænsninger

• Du kan få beskeder, der senest er opdateret i henhold til din konfigurerede opbevaringsperiode.
• Hastighedsbegrænsninger for denne API er 100 opkald pr. minut og 1500 opkald pr. time.

Tilladelser

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

• Brugeren skal som minimum have følgende rolletilladelse: 'Vis data'. Du kan få flere oplysninger under Opret og administrer roller.

• Brugeren skal have adgang til den enhed, der er knyttet til beskeden, baseret på indstillingerne for enhedsgruppe. Du kan få flere oplysninger under Opret og administrer enhedsgrupper.

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 Microsoft Defender for Endpoint API'er.

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

HTTP-anmodning

GET /api/alerts/{id}

Anmodningsheadere

Navn	Type	Beskrivelse
Tilladelse	String	Ihændehaver {token}. Påkrævet.

Brødtekst i anmodning

Tom

Svar

Hvis det lykkes, returnerer denne metode 200 OK og beskedenheden i svarbrødteksten. Hvis der ikke blev fundet en besked med det angivne id – 404 blev ikke fundet.