Hae tarkistushistoria määritelmän mukaan

Artikkeli
08/14/2024

Koskee seuraavia:

Haluatko kokea Microsoft Defender for Endpointin? Rekisteröidy maksuttomaan kokeiluversioon.

Haluatko kokea Microsoft Defenderin haavoittuvuuden hallinnan? Katso, miten voit rekisteröityä ilmaiseen kokeiluversioon.

Tärkeää

Jotkin tämän artikkelin tiedot liittyvät tuotteen ennakkojulkaisuversioon, jota voidaan muuttaa huomattavasti ennen kaupallista julkaisua. Microsoft ei anna mitään takuita tässä annettujen tietojen suhteen.

Huomautus

Jos olet Yhdysvaltain valtionhallinnon asiakas, käytä Microsoft Defender for Endpoint for Us Government -asiakkaille lueteltuja URI-osoitteita.

Vihje

Suorituskyvyn parantamiseksi voit käyttää palvelinta lähempänä maantieteellistä sijaintiasi:

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

Ohjelmointirajapinnan kuvaus

Hakee luettelon tarkistushistoriasta määritysten mukaan.

Tukee OData-toimintoja.
Tuetut OData-operaattorit:
- $top, jonka enimmäisarvo on 4096. Palauttaa pyynnössä määritettyjen istuntojen määrän.
- $skip, jonka oletusarvo on 0. Ohittaa pyynnössä määritettyjen istuntojen määrän.

Jos haluat esimerkin OData-toiminnon käytöstä, katso esimerkki $top pyyntö.

Rajoitukset

Tämän ohjelmointirajapinnan nopeusrajoitukset ovat 100 puhelua minuutissa ja 1 500 puhelua tunnissa.

Käyttöoikeudet

Tämän ohjelmointirajapinnan kutsumiseen tarvitaan jokin seuraavista käyttöoikeuksista. Lisätietoja käyttöoikeuksien valitsemisesta on artikkelissa Microsoft Defenderin käyttö päätepisteen ohjelmointirajapinnoille.

Käyttöoikeustyyppi	Lupa	Käyttöoikeuden näyttönimi
Sovellus	Machine.Read.All	Lue kaikki skannaustiedot.
Delegoitu (työpaikan tai oppilaitoksen tili)	Machine.Read.All	Lue kaikki skannaustiedot.

Huomautus

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

Jotta käyttäjä voi tarkastella tietoja, hänellä on oltava vähintään seuraavat roolioikeudet: ViewData tai TvmViewData (lisätietoja on artikkelissa Roolien luominen ja hallinta )

HTTP-pyyntö

POST api/DeviceAuthenticatedScanDefinitions/GetScanHistoryByScanDefinitionId

Pyynnön otsikot

Nimi	Kirjoita	Kuvaus
Lupa	Merkkijono	Haltija {token}. Pakollinen.
Sisältötyyppi	merkkijono	application/json. Pakollinen.

Pyynnön leipäteksti

Anna pyynnön leipätekstissä JSON-objekti, jolla on seuraavat parametrit:

Parametri	Kirjoita	Kuvaus
ScanDefinitionIds	Merkkijono	Tarkistuksen tunnus. Pakollinen.

Vastaus

Jos tämä menetelmä onnistuu, se palauttaa arvon 200 – OK-vastauskoodi, jossa on luettelo tarkistushistoriasta määrityksen mukaan.

Esimerkkipyyntö

Tässä on esimerkki pyynnöstä.

POST https://api.securitycenter.microsoft.com/api/DeviceAuthenticatedScanDefinitions/GetScanHistoryByScanDefinitionId

{
    "ScanDefinitionIds": ["4ad8d463-6b3a-4894-b42a-a2de9ea0a8ae", "60c4aa57-c573-4488-8d18-230914792a92", "c6220f67-2cad-4ba3-a2fa-7ded6384da56"]
}

Vastausesimerkki

{
"@odata.context": "https://api.securitycenter.microsoft.com/api/DeviceAuthenticatedScanDefinitions/GetScanHistoryByScanDefinitionId",
    "value": [
    {
    "ScanDefinitionIds": "4ad8d463-6b3a-4894-b42a-a2de9ea0a8ae",
    "LastScanned": "2022-12-20T11:14:24.5561791Z",
    "ScanStatus": "Partial Success",
    "ScannerId": "625431694b7d2ca9d07e77ca1b029ef216bebb6d"
    },
    {
    "ScanDefinitionIds": "60c4aa57-c573-4488-8d18-230914792a92",
    "LastScanned": "2022-11-17T15:13:24.5561791Z",
    "ScanStatus": "Partial Success",
    "ScannerId": "625431694b7d2ca9d07e77ca1b029ef216bebb6d"
    },
    {
    "ScanDefinitionIds": "c6220f67-2cad-4ba3-a2fa-7ded6384da56",
    "LastScanned": "2022-11-10T18:15:24.5561791Z",
    "ScanStatus": "Partial Success",
    "ScannerId": "625431694b7d2ca9d07e77ca1b029ef216bebb6d"
    },
   ]
}

Esimerkki pyynnön $top

Tässä on esimerkki pyynnöstä, joka palauttaa vain yhden istunnon.

POST https://api.securitycenter.microsoft.com/api/DeviceAuthenticatedScanDefinitions/GetScanHistoryByScanDefinitionId?$top=1

$top vastausesimerkki

{
"@odata.context": "https://api.securitycenter.microsoft.com/api/DeviceAuthenticatedScanDefinitions/GetScanHistoryByScanDefinitionId",
    "value": [
    {
    "ScanDefinitionIds": "4ad8d463-6b3a-4894-b42a-a2de9ea0a8ae",
    "LastScanned": "2022-12-20T11:14:24.5561791Z",
    "ScanStatus": "Partial Success",
    "ScannerId": "625431694b7d2ca9d07e77ca1b029ef216bebb6d"
    },
 ]
}

Jaa