Megosztás a következőn keresztül:

Intune jelentések exportálása Graph API-k használatával

Az Intune jelentési infrastruktúrába migrált összes jelentés egyetlen legfelső szintű exportálási API-ból lesz exportálható. A HTTP-hívás indításához a Microsoft Graph API kell használnia. A Microsoft Graph egy RESTful webes API, amely lehetővé teszi a Microsoft Felhőszolgáltatás erőforrásainak elérését.

Megjegyzés:

További információ a REST API-hívások kezdeményezéséről, beleértve a Microsoft Graph-tal való interakció eszközeit is, lásd: A Microsoft Graph API használata.

Microsoft Intune a következő Microsoft Graph API végpont használatával exportál jelentéseket:

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

Példaeszközök jelentéskérésre és válaszra

A kérés végrehajtásakor meg kell adnia egy paramétert reportName a kérelem törzsének részeként az exportálni kívánt jelentés alapján. Az alábbiakban egy példa látható egy exportálási kérelemre az Eszközök jelentéshez. A kéréshez a POST HTTP metódust kell használnia. A POST metódussal új erőforrást hozhat létre, vagy műveleteket hajthat végre.

Példa kérésre

Az alábbi kérés a Microsoft Graphnak küldött kéréshez használt HTTP-metódust tartalmazza.

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

Megjegyzés:

Az adatok lekéréséhez válasszon ki bizonyos oszlopokat, például a fenti példában megadottakat. Ne építsen automatizálást a jelentések exportálásának alapértelmezett oszlopai köré. Az automatizálást úgy kell felépítenie, hogy explicit módon válassza ki a megfelelő oszlopokat.

Példa válaszra

A fenti POST kérés alapján a Graph válaszüzenetet ad vissza. A válaszüzenet a kért adatok vagy a művelet eredménye.

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

Ezután a id mező használatával lekérdezheti az exportálás állapotát egy GET kéréssel:

Például: https://graph.microsoft.com/beta/deviceManagement/reports/exportJobs('Devices_05e62361-783b-4cec-b635-0aed0ecf14a3') vagy https://graph.microsoft.com/beta/deviceManagement/reports/exportJobs/Devices_05e62361-783b-4cec-b635-0aed0ecf14a3

Addig kell meghívnia ezt az URL-címet, amíg egy attribútummal rendelkező status: completed választ nem kap. A következő példához hasonlóan néz ki:

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

Ezután közvetlenül letöltheti a tömörített CSV-t a url mezőről.

Jelentésparaméterek

A kérelem törzsében öt fő paramétert küldhet be az exportálási kérelem meghatározásához:

  • reportName:Szükséges. Ez a paraméter annak a jelentésnek a neve, amelyet meg szeretne adni.
  • filter: A legtöbb jelentéshez nem szükséges. A szűrőparaméter egy sztring.
  • select: Nem kötelező. Adja meg, hogy a jelentés mely oszlopai jelenjenek meg. Csak a meghívni kívánt jelentéshez kapcsolódó érvényes oszlopnevek lesznek elfogadva.
  • format: Nem kötelező. Alapértelmezés szerint az adatok formátuma csv a kimenet. Adja meg json a parancsot a fájl JSON formátumban történő kimenetéhez.
  • localizationType: Ez a paraméter szabályozza a jelentés honosítási viselkedését. A lehetséges értékek a következők: LocalizedValuesAsAdditionalColumn és ReplaceLocalizableValues.

Honosítási viselkedés

A localizationType paraméter szabályozza a jelentés honosítási viselkedését. Ennek a paraméternek a lehetséges értékei a következők: LocalizedValuesAsAdditionalColumn és ReplaceLocalizableValues.

LocalizedValuesAsAdditionalColumn jelentésérték

Ez a localizationType paraméter értéke az alapértelmezett érték. A rendszer automatikusan beszúrja, ha a localizationType paraméter nincs megadva. Ez az érték azt határozza meg, hogy Intune két oszlopot biztosít minden honosítható oszlophoz.

  • enumerálási érték: Az enumerálási érték oszlop egy nyers sztringet vagy olyan számkészletet tartalmaz, amely a területi beállításoktól függetlenül nem változik. Ez az oszlop az eredeti oszlopnév alatt található (lásd a példát).
  • honosított sztringérték: Ez az oszlop az eredeti oszlop neve _loc hozzáfűzve. Emberi olvasásra alkalmas sztringértékeket és feltételes területi beállításokat tartalmaz (lásd a példát).

Példa

Operációs rendszer OS_loc
1 A Windows
1 A Windows
1 A Windows
2 iOS
3 Android
4 Mac

ReplaceLocalizableValues jelentés értéke

A ReplaceLocalizableValues jelentés értéke honosított attribútumonként csak egy oszlopot ad vissza. Ez az oszlop tartalmazza az eredeti oszlopnevet a honosított értékekkel.

Példa

Operációs rendszer
A Windows
A Windows
A Windows
iOS
Android
Mac

Honosított értékekkel nem rendelkező oszlopok esetén a rendszer csak egyetlen oszlopot ad vissza a valódi oszlopnévvel és a valódi oszlopértékekkel.

Fontos

A localizationType paraméter a Intune jelentéskészítési infrastruktúrája által üzemeltetett exportálási folyamatok esetében releváns, néhány kivétellel. ADevices és DevicesWithInventory jelentéstípusok az örökölt kompatibilitási követelmények miatt nem tartják be a localizationType paramétert.

API-szabályozási feltételek

Annak érdekében, hogy az exportJobs API ne rendelkezzen túl sok egyidejű kéréssel, ami hatással lenne az API válaszsebességére, a rendszer az alábbi szabályozási korlátokat alkalmazza.

  • Az API-k bérlőnként legfeljebb 100 kérést támogatnak percenként: Ez a támogatás a bérlő összes felhasználójára és alkalmazására kiterjed. A bérlőben lévő felhasználók vagy alkalmazások által ugyanazon a percen belül kezdeményezett további kérések szabályozva lesznek.
    • Ha az API-kat egy felhasználó kezdeményezi, egy percen belül akár 8 kérést is engedélyezhet ugyanaz a felhasználó. Ugyanannak a felhasználónak az ugyanazon a percen belüli további kérései szabályozva lesznek.
    • Ha az API-kat egy alkalmazás kezdeményezi, akkor egy percen belül akár 48 kérést is engedélyezhet ugyanaz az alkalmazás. Ugyanannak az alkalmazásnak az ugyanazon a percen belüli további kérései szabályozva lesznek.

Következő lépések