Delen via

Intune rapporten exporteren met graph-API's

  • Artikel

Alle rapporten die zijn gemigreerd naar de Intune rapportage-infrastructuur, zijn beschikbaar voor export vanuit één export-API op het hoogste niveau. U moet de Microsoft-Graph API gebruiken om de HTTP-aanroep te doen. Microsoft Graph is een RESTful-web-API waarmee u toegang hebt tot microsoft cloudserviceresources.

Opmerking

Zie De Microsoft-Graph API gebruiken voor meer informatie over het maken van REST API-aanroepen, inclusief hulpprogramma's voor interactie met Microsoft Graph.

Microsoft Intune exporteert rapporten met behulp van het volgende Microsoft Graph API-eindpunt:

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

Voorbeeld van een apparaat dat aanvraag en antwoord rapporteert

Wanneer u de aanvraag indient, moet u een reportName parameter opgeven als onderdeel van de aanvraagbody op basis van het rapport dat u wilt exporteren. Hieronder ziet u een voorbeeld van een exportaanvraag voor het rapport Apparaten . U moet de HTTP-methode POST gebruiken voor uw aanvraag. De POST-methode wordt gebruikt om een nieuwe resource te maken of een actie uit te voeren.

Voorbeeld van aanvraag

De onderstaande aanvraag bevat de HTTP-methode die wordt gebruikt voor de aanvraag bij Microsoft Graph.

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

Opmerking

Als u gegevens wilt ophalen, selecteert u specifieke kolommen, zoals de kolommen die in het bovenstaande voorbeeld zijn opgegeven. Bouw geen automatisering rond standaardkolommen van een rapportexport. U moet uw automatisering bouwen om expliciet relevante kolommen te selecteren.

Antwoordvoorbeeld

Op basis van de bovenstaande POST-aanvraag retourneert Graph een antwoordbericht. Het antwoordbericht bestaat uit de gegevens die u hebt aangevraagd of het resultaat van de bewerking.

{ 
    "@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" 
}

Vervolgens kunt u het id veld gebruiken om de status van de export op te vragen met een GET-aanvraag:

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

U moet deze URL blijven aanroepen totdat u een antwoord met een status: completed kenmerk krijgt. Dit ziet eruit als het volgende voorbeeld:

{ 
    "@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" 
}

Vervolgens kunt u het gecomprimeerde CSV-bestand rechtstreeks downloaden vanuit het url veld.

Rapportparameters

Er zijn vijf belangrijke parameters die u kunt indienen in de hoofdtekst van uw aanvraag om de exportaanvraag te definiëren:

  • reportName:Vereist. Deze parameter is de naam van het rapport dat u wilt opgeven.
  • filter: niet vereist voor de meeste rapporten. De filterparameter is een tekenreeks.
  • select: niet vereist. Geef op welke kolommen van het rapport u wilt gebruiken. Alleen geldige kolomnamen die relevant zijn voor het rapport dat u aanroept, worden geaccepteerd.
  • format: niet vereist. De gegevens worden standaard uitgevoerd in csv de indeling. Geef op json om het bestand uit te voeren in JSON-indeling.
  • localizationType: deze parameter bepaalt het lokalisatiegedrag voor het rapport. Mogelijke waarden zijn LocalizedValuesAsAdditionalColumn en ReplaceLocalizableValues.

Lokalisatiegedrag

De localizationType parameter bepaalt het lokalisatiegedrag voor het rapport. De mogelijke waarden voor deze parameter zijn LocalizedValuesAsAdditionalColumn en ReplaceLocalizableValues.

LocalizedValuesAsAdditionalColumn-rapportwaarde

Deze waarde voor de localizationType parameter is de standaardwaarde. Deze wordt automatisch ingevoegd als de localizationType parameter niet is opgegeven. Deze waarde geeft aan dat Intune twee kolommen biedt voor elke lokaliseerbare kolom.

  • enumwaarde: de kolom enumwaarde bevat een onbewerkte tekenreeks of een reeks getallen die niet veranderen, ongeacht de landinstelling. Deze kolom bevindt zich onder de oorspronkelijke kolomnaam (zie voorbeeld).
  • gelokaliseerde tekenreekswaarde: deze kolom is de oorspronkelijke kolomnaam met _loc toegevoegd. Het bevat tekenreekswaarden die door mensen kunnen worden gelezen en de landinstelling voorwaardelijk (zie voorbeeld).

Voorbeeld

BESTURINGSSYSTEEM OS_loc
1 Windows
1 Windows
1 Windows
2 iOS
3 Android
4 Mac

Rapportwaarde ReplaceLocalizableValues

De rapportwaarde ReplaceLocalizableValues retourneert slechts één kolom per gelokaliseerd kenmerk. Deze kolom bevat de oorspronkelijke kolomnaam met de gelokaliseerde waarden.

Voorbeeld

BESTURINGSSYSTEEM
Windows
Windows
Windows
iOS
Android
Mac

Voor kolommen zonder gelokaliseerde waarden wordt slechts één kolom met de werkelijke kolomnaam en de werkelijke kolomwaarden geretourneerd.

Belangrijk

De localizationType parameter is relevant voor elke exportervaring die wordt gehost door de rapportage-infrastructuur van Intune, met een paar uitzonderingen. DeDevices rapporttypen en DevicesWithInventory voldoen niet aan de localizationType parameter vanwege verouderde compatibiliteitsvereisten.

API-beperkingsvoorwaarden

Om ervoor te zorgen dat de exportJobs API niet te veel gelijktijdige aanvragen heeft, wat van invloed zou zijn op de reactiesnelheid van de API, worden de onderstaande beperkingslimieten toegepast.

  • De API's ondersteunen maximaal 100 aanvragen per tenant per minuut: Deze ondersteuning heeft betrekking op alle gebruikers en apps in een tenant. Eventuele extra aanvragen die binnen dezelfde minuut door gebruikers of apps in de tenant worden geïnitieerd, worden beperkt.
    • Als de API's worden geïnitieerd door een gebruiker, worden maximaal 8 aanvragen binnen een minuut door dezelfde gebruiker toegestaan. Volgende aanvragen van dezelfde gebruiker binnen dezelfde minuut worden beperkt.
    • Als de API's worden geïnitieerd door een app, worden binnen een minuut maximaal 48 aanvragen door dezelfde app toegestaan. Volgende aanvragen door dezelfde app binnen dezelfde minuut worden beperkt.

Volgende stappen