Get Machines security states collection API

Gäller för:

Vill du uppleva Microsoft Defender för Endpoint? Registrera dig för en kostnadsfri utvärderingsversion.

Anteckning

Om du är myndighetskund i USA kan du använda de URI:er som visas i Microsoft Defender för Slutpunkt för kunder inom myndigheter i USA.

Tips

För bättre prestanda kan du använda servern närmare din geografiska plats:

  • api-us.securitycenter.microsoft.com
  • api-eu.securitycenter.microsoft.com
  • api-uk.securitycenter.microsoft.com

Hämtar en samling säkerhets tillstånd för enheter.

Behörigheter

Användaren behöver läsbehörighet.

HTTP-begäran

GET /testwdatppreview/machinesecuritystates

Frågerubriker

Rubrik Värde
Auktorisering Bearer {token}. Obligatoriskt.
Innehållstyp application/json

Frågebrödtext

Tom

Svar

Om det lyckas – 200 OK.

Exempel

Exempel på förfrågan

Här är ett exempel på begäran.

GET https://graph.microsoft.com/testwdatppreview/machinesecuritystates
Content-type: application/json

Svarsexempel

Här är ett exempel på svaret.

Fält-ID innehåller enhets-ID och är lika med fält-ID* i enhetsinformation.

HTTP/1.1 200 OK
Content-type: application/json
{
    "@odata.context":"https://graph.microsoft.com/testwdatppreview/$metadata#MachineSecurityStates",
    "@odata.count":444,
    "@odata.nextLink":"https://graph.microsoft.com/testwdatppreview/machinesecuritystates?$skiptoken=[continuation token]",
    "value":[
        {
            "id":"000050e1b4afeee3742489ede9ad7a3e16bbd9c4",
            "build":14393,
            "revision":2485,
            "architecture":"Amd64",
            "osVersion":"10.0.14393.2485.amd64fre.rs1_release.180827-1809",
            "propertiesRequireAttention":[
                "AntivirusNotReporting",
                "EdrImpairedCommunications"
            ]
        },
        ...
    ]
}