List MachineActions -ohjelmointirajapinta

Koskee seuraavia:: Microsoft Defender for Endpoint Plan 1, Microsoft Defender for Endpoint Plan 2

Ohjelmointirajapinnan kuvaus

Noutaa konetoimintojen kokoelman.

Tukee OData V4 -kyselyitä. Tuetut OData-operaattorit:

$filter seuraavissa ominaisuuksissa:
- id
- status
- machineId
- type
- requestor
- creationDateTimeUtc
$stop suurin arvo on 10 000.
$skip

Katso esimerkkejä OData-kyselyistä, joissa on Microsoft Defender for Endpoint.

Rajoitukset

Sivun enimmäiskoko on 10 000.
Tämän ohjelmointirajapinnan nopeusrajoitukset ovat 100 puhelua minuutissa ja 1 500 puhelua tunnissa.

Käyttöoikeudet

Kun hankit tunnuksen käyttäjän tunnistetiedoilla:

Käyttäjällä on oltava vähintään seuraava roolioikeus: Näytä tiedot. Lisätietoja on ohjeaiheessa Roolien luominen ja hallinta.

Tämän ohjelmointirajapinnan kutsumiseen tarvitaan jokin seuraavista käyttöoikeuksista. Lisätietoja ja käyttöoikeuksien valitseminen on artikkelissa Microsoft Defender for Endpoint ohjelmointirajapintoja

Käyttöoikeustyyppi	Lupaa	Käyttöoikeuden näyttönimi
Sovellus	Machine.ReadWrite.All	"Kaikkien konetietojen luku- ja kirjoitusoikeudet"
Delegoitu (työpaikan tai oppilaitoksen tili)	Machine.ReadWrite	"Konetietojen lukeminen ja kirjoittaminen"

HTTP-pyyntö

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

Pyynnön otsikot

Nimi	Kirjoita	Kuvaus
Lupa	Merkkijono	Haltija {token}. Pakollinen.

Pyynnön leipäteksti

Tyhjä

Vastaus

Jos tämä menetelmä onnistuu, se palauttaa arvon 200, OK-vastauskoodi, jossa on kokoelma machineAction-entiteettejä .

Esimerkki 1

Esimerkki 1 -pyyntö

Tässä on esimerkki pyynnöstä organisaatiolle, jolla on kolme konetoimintoa.

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

Esimerkki 1 vastaus

Tässä on esimerkki vastauksesta.

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"
            }
        }
    ]
}

Esimerkki 2

Esimerkki 2 -pyyntö

Tässä on esimerkki pyynnöstä, joka suodattaa konetunnukset konetunnuksen mukaan ja näyttää kaksi viimeisintä konetoimintoa.

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

Esimerkki 2 vastaus