API for listeindikatorer

Artikkel
08/14/2024

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

Henter en samling av alle aktive indikatorer.

Støtter OData V4-spørringer.

OData-spørringen støttes på: application, , createdByDisplayName, expirationTime, generateAlerttitle, , rbacGroupNamesrbacGroupIds, indicatorValue, indicatorType, createdBycreationTimeDateTimeUtc, action, og severity egenskaper.$filter
$stop med maksimumsverdien 10 000.
$skip.

Se eksempler på OData-spørringer med Microsoft Defender for Endpoint.

Begrensninger

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 Komme i gang.

Tillatelsestype	Tillatelse	Visningsnavn for tillatelse
Program	Ti.ReadWrite	`Read and write Indicators`
Program	Ti.ReadWrite.All	`Read and write All Indicators`
Delegert (jobb- eller skolekonto)	Ti.ReadWrite	`Read and write Indicators`

HTTP-forespørsel

GET https://api.securitycenter.microsoft.com/api/indicators

Forespørselshoder

Navn	Type:	Beskrivelse
Autorisasjon	Streng	Bærer {token}. Obligatorisk.

Forespørselstekst

Tom

Svar

Hvis vellykket, returnerer denne metoden 200, OK-svarkode med en samling indikatorenheter .

Obs!

Hvis programmet har Ti.ReadWrite.All tillatelse, vil det bli utsatt for alle indikatorer. Ellers vises den bare for indikatorene den opprettet.

Eksempel 1

Eksempel 1-forespørsel

Her er et eksempel på en forespørsel som henter alle indikatorer.

GET https://api.securitycenter.microsoft.com/api/indicators

Eksempel 1-svar

Her er et eksempel på svaret.

HTTP/1.1 200 Ok
Content-type: application/json
{
    "@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#Indicators",
    "value": [
        {
            "id": "995",
            "indicatorValue": "12.13.14.15",
            "indicatorType": "IpAddress",
            "action": "Alert",
            "application": "demo-test",
            "source": "TestPrdApp",
            "sourceType": "AadApp",
            "title": "test",
            "creationTimeDateTimeUtc": "2018-10-24T11:15:35.3688259Z",
            "createdBy": "45097602-1234-5678-1234-9f453233e62c",
            "expirationTime": "2020-12-12T00:00:00Z",
            "lastUpdateTime": "2019-10-24T10:54:23.2009016Z",
            "lastUpdatedBy": TestPrdApp,
            "severity": "Informational",
            "description": "test",
            "recommendedActions": "test",
            "rbacGroupNames": []
        },
        {
            "id": "996",
            "indicatorValue": "220e7d15b0b3d7fac48f2bd61114db1022197f7f",
            "indicatorType": "FileSha1",
            "action": "AlertAndBlock",
            "application": null,
            "source": "TestPrdApp",
            "sourceType": "AadApp",
            "title": "test",
            "creationTimeDateTimeUtc": "2018-10-24T10:54:23.2009016Z",
            "createdBy": "45097602-1234-5678-1234-9f453233e62c",
            "expirationTime": "2020-12-12T00:00:00Z",
            "lastUpdateTime": "2019-10-24T10:54:23.2009016Z",
            "lastUpdatedBy": TestPrdApp,
            "severity": "Informational",
            "description": "test",
            "recommendedActions": "TEST",
            "rbacGroupNames": [ "Group1", "Group2" ]
        }
        ...
    ]
}

Eksempel 2

Eksempel 2-forespørsel

Her er et eksempel på en forespørsel som får alle indikatorer med AlertAndBlock handling.

GET https://api.securitycenter.microsoft.com/api/indicators?$filter=action+eq+'AlertAndBlock'

Eksempel 2 svar