Liste over MachineActions-API'er

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

API-beskrivelse

Henter en samling af computerhandlinger.

Understøtter OData V4-forespørgsler. OData-understøttede operatorer:

$filter på følgende egenskaber:
- id
- status
- machineId
- type
- requestor
- creationDateTimeUtc
$stop med en maksimumværdi på 10.000.
$skip

Se eksempler på OData-forespørgsler med Microsoft Defender for Endpoint.

Begrænsninger

Den maksimale sidestørrelse er 10.000.
Hastighedsbegrænsninger for denne API er 100 opkald pr. minut og 1.500 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.

En af følgende tilladelser er påkrævet for at kalde denne API. Du kan få mere at vide, herunder hvordan du vælger tilladelser, under Brug Microsoft Defender for Endpoint 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

GET https://api.security.microsoft.com/api/machineactions

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-svarkode med en samling machineAction-enheder .

Eksempel 1

Eksempel 1-anmodning

Her er et eksempel på anmodningen for en organisation, der har tre MachineActions.

GET https://api.security.microsoft.com/api/machineactions

Eksempel 1-svar

Her er et eksempel på svaret.

HTTP/1.1 200 Ok
Content-type: application/json
{
    "@odata.context": "https://api.security.microsoft.com/api/$metadata#MachineActions",
    "value": [
        {
            "id": "69dc3630-1ccc-4342-acf3-35286eec741d",
            "type": "CollectInvestigationPackage",
            "scope": null,
            "requestor": "Analyst@contoso.com",
            "requestorComment": "test",
            "status": "Succeeded",
            "machineId": "f46b9bb259ed4a7fb9981b73510e3cc7aa81ec1f",
            "computerDnsName": "desktop-39g9tgl",
            "creationDateTimeUtc": "2018-12-04T12:43:57.2011911Z",
            "lastUpdateTimeUtc": "2018-12-04T12:45:25.4049122Z",
            "relatedFileInfo": null
        },
        {
            "id": "2e9da30d-27f6-4208-81f2-9cd3d67893ba",
            "type": "RunAntiVirusScan",
            "scope": "Full",
            "requestor": "Analyst@contoso.com",
            "requestorComment": "Check machine for viruses due to alert 3212",
            "status": "Succeeded",
            "machineId": "f46b9bb259ed4a7fb9981b73510e3cc7aa81ec1f",
            "computerDnsName": "desktop-39g9tgl",
            "creationDateTimeUtc": "2018-12-04T12:18:27.1293487Z",
            "lastUpdateTimeUtc": "2018-12-04T12:18:57.5511934Z",
            "relatedFileInfo": null
        },
        {
            "id": "44cffc15-0e3d-4cbf-96aa-bf76f9b27f5e",
            "type": "StopAndQuarantineFile",
            "scope": null,
            "requestor": "Analyst@contoso.com",
            "requestorComment": "test",
            "status": "Succeeded",
            "machineId": "f46b9bb259ed4a7fb9981b73510e3cc7aa81ec1f",
            "computerDnsName": "desktop-39g9tgl",
            "creationDateTimeUtc": "2018-12-04T12:15:40.6052029Z",
            "lastUpdateTimeUtc": "2018-12-04T12:16:14.2899973Z",
            "relatedFileInfo": {
                "fileIdentifier": "a0c659857ccbe457fdaf5fe21d54efdcbf6f6508",
                "fileIdentifierType": "Sha1"
            }
        }
    ]
}

Eksempel 2

Eksempel 2-anmodning

Her er et eksempel på en anmodning, der filtrerer MachineActions efter computer-id og viser de seneste to MachineActions.

GET https://api.security.microsoft.com/api/machineactions?$filter=machineId eq 'f46b9bb259ed4a7fb9981b73510e3cc7aa81ec1f'&$top=2

Eksempel 2-svar