Dela via


Exportera Intune rapporter med graph-API:er

Alla rapporter som har migrerats till Intune rapporteringsinfrastruktur kommer att vara tillgängliga för export från ett enda api för toppnivåexport. Du måste använda Microsoft Graph API för att göra HTTP-anropet. Microsoft Graph är ett RESTful-webb-API som gör att du kan komma åt Microsoft Cloud-tjänstresurser.

Obs!

Information om hur du gör REST API-anrop, inklusive verktyg för att interagera med Microsoft Graph, finns i Använda Microsoft Graph API.

Microsoft Intune exporterar rapporter med hjälp av följande Microsoft Graph API-slutpunkt:

https://graph.microsoft.com/beta/deviceManagement/reports/exportJobs
https://graph.microsoft.com/v1.0/deviceManagement/reports/exportJobs

Exempelenheter rapporterar begäran och svar

När du gör begäran måste du ange en parameter som en reportName del av begärandetexten baserat på den rapport som du vill exportera. Nedan visas ett exempel på en exportbegäran för rapporten Enheter . Du måste använda POST HTTP-metoden på din begäran. POST-metoden används för att skapa en ny resurs eller utföra en åtgärd.

Exempel på begäran

Begäran nedan innehåller HTTP-metoden som används för begäran till Microsoft Graph.

{ 
    "reportName": "Devices", 
    "filter":"(OwnerType eq '1')", 
    "localizationType": "LocalizedValuesAsAdditionalColumn", 
    "format": "json",
    "select": [ 
        "DeviceName", 
        "managementAgent", 
        "ownerType", 
        "complianceState", 
        "OS", 
        "OSVersion", 
        "LastContact", 
        "UPN", 
        "DeviceId" 
    ]
} 

Obs!

Om du vill hämta data väljer du specifika kolumner, till exempel de som anges i exemplet ovan. Skapa inte automatisering runt standardkolumner för någon rapportexport. Du bör skapa din automatisering för att uttryckligen välja relevanta kolumner.

Svarsexempel

Baserat på postbegäran ovan returnerar Graph ett svarsmeddelande. Svarsmeddelandet är de data som du begärde eller resultatet av åtgärden.

{ 
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#deviceManagement/reports/exportJobs/$entity", 
    "id": "Devices_05e62361-783b-4cec-b635-0aed0ecf14a3", 
    "reportName": "Devices", 
    "filter":"(OwnerType eq '1')", 
    "localizationType": "LocalizedValuesAsAdditionalColumn", 
    "select": [ 
        "DeviceName", 
        "managementAgent", 
        "ownerType", 
        "complianceState", 
        "OS", 
        "OSVersion", 
        "LastContact", 
        "UPN", 
        "DeviceId" 
    ], 
    "format": "csv", 
    "snapshotId": null, 
    "status": "notStarted", 
    "url": null, 
    "requestDateTime": "2020-08-19T03:43:32.1405758Z", 
    "expirationDateTime": "0001-01-01T00:00:00Z" 
} 

Du kan sedan använda fältet id för att fråga efter status för exporten med en GET-begäran:

Till exempel: https://graph.microsoft.com/beta/deviceManagement/reports/exportJobs('Devices_05e62361-783b-4cec-b635-0aed0ecf14a3') eller https://graph.microsoft.com/beta/deviceManagement/reports/exportJobs/Devices_05e62361-783b-4cec-b635-0aed0ecf14a3

Du måste fortsätta att anropa den här URL:en tills du får ett svar med ett status: completed attribut. Det ser ut som i följande exempel:

{ 
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#deviceManagement/reports/exportJobs/$entity", 
    "id": "Devices_05e62361-783b-4cec-b635-0aed0ecf14a3", 
    "reportName": "Devices", 
    "filter":"(OwnerType eq '1')", 
    "localizationType": "LocalizedValuesAsAdditionalColumn", 
    "select": [ 
        "DeviceName", 
        "managementAgent", 
        "ownerType", 
        "complianceState", 
        "OS", 
        "OSVersion", 
        "LastContact", 
        "UPN", 
        "DeviceId" 
    ], 
    "format": "csv", 
    "snapshotId": null, 
    "status": "completed", 
    "url": "https://amsua0702repexpstorage.blob.core.windows.net/cec055a4-97f0-4889-b790-dc7ad0d12c29/Devices_05e62361-783b-4cec-b635-0aed0ecf14a3.zip?sv=2019-02-02&sr=b&sig=%2BP%2B4gGiZf0YzlQRuAV5Ji9Beorg4nnOtP%2F7bbFGH7GY%3D&skoid=1db6df02-4c8b-4cb3-8394-7ac2390642f8&sktid=72f988bf-86f1-41af-91ab-2d7cd011db47&skt=2020-08-19T03%3A48%3A32Z&ske=2020-08-19T09%3A44%3A23Z&sks=b&skv=2019-02-02&se=2020-08-19T09%3A44%3A23Z&sp=r", 
    "requestDateTime": "2020-08-19T03:43:32.1405758Z", 
    "expirationDateTime": "2020-08-19T09:44:23.8540289Z" 
} 

Du kan sedan ladda ned den komprimerade CSV:n direkt från url fältet.

Rapportparametrar

Det finns fem huvudparametrar som du kan skicka i begärandetexten för att definiera exportbegäran:

  • reportName:Krävs. Den här parametern är namnet på den rapport som du vill ange.
  • filter: Krävs inte för de flesta rapporter. Filterparametern är en sträng.
  • select: Krävs inte. Ange vilka kolumner från rapporten som du vill använda. Endast giltiga kolumnnamn som är relevanta för den rapport som du anropar accepteras.
  • format: Krävs inte. Som standard är data utdata i csv format. Ange json att filen ska matas ut i JSON-format.
  • localizationType: Den här parametern styr lokaliseringsbeteendet för rapporten. Möjliga värden är LocalizedValuesAsAdditionalColumn och ReplaceLocalizableValues.

Lokaliseringsbeteende

Parametern localizationType styr lokaliseringsbeteendet för rapporten. Möjliga värden för den här parametern är LocalizedValuesAsAdditionalColumn och ReplaceLocalizableValues.

LocalizedValuesAsAdditionalColumn-rapportvärde

Det här värdet för parametern localizationType är standardvärdet. Den infogas automatiskt om parametern localizationType inte har angetts. Det här värdet anger att Intune innehåller två kolumner för varje lokaliserbar kolumn.

  • uppräkningsvärde: Uppräkningsvärdekolumnen innehåller antingen en råsträng eller en uppsättning tal som inte ändras, oavsett nationella inställningar. Den här kolumnen är under det ursprungliga kolumnnamnet (se exempel).
  • lokaliserat strängvärde: Den här kolumnen är det ursprungliga kolumnnamnet med _loc tillagt. Den innehåller strängvärden som är läsbara för människor och villkorsstyrda nationella inställningar (se exempel).

Exempel

ÅS OS_loc
1 Windows
1 Windows
1 Windows
2 iOS
3 Android
4 Mac

ReplaceLocalizableValues-rapportvärde

ReplaceLocalizableValues-rapportvärdet returnerar bara en kolumn per lokaliserat attribut. Den här kolumnen innehåller det ursprungliga kolumnnamnet med de lokaliserade värdena.

Exempel

ÅS
Windows
Windows
Windows
iOS
Android
Mac

För kolumner utan lokaliserade värden returneras endast en enda kolumn med det sanna kolumnnamnet och de sanna kolumnvärdena.

Viktigt

Parametern localizationType är relevant för alla exportupplevelser som hanteras av Intune rapporteringsinfrastruktur med några få undantag. RapporttypernaDevices och DevicesWithInventory följer inte parametern localizationType på grund av äldre kompatibilitetskrav.

VILLKOR FÖR API-begränsning

För att säkerställa att API:et exportJobs inte har för många samtidiga begäranden, vilket skulle påverka API:ets svarsfrekvens, tillämpas begränsningarna nedan.

  • API:erna stöder upp till 100 begäranden per klientorganisation per minut: Det här stödet omfattar alla användare och appar i en klientorganisation. Eventuella ytterligare begäranden som initieras av antingen användare eller appar i klientorganisationen inom samma minut begränsas.
    • Om API:erna initieras av en användare tillåts upp till 8 begäranden av samma användare inom en minut. Efterföljande begäranden av samma användare inom samma minut begränsas.
    • Om API:erna initieras av en app tillåts upp till 48 begäranden av samma app inom en minut. Efterföljande begäranden från samma app inom samma minut begränsas.

Nästa steg