Export sestav Intune pomocí rozhraní Graph API

  • Článek

Všechny sestavy, které byly migrovány do infrastruktury sestav Intune, budou k dispozici pro export z jednoho rozhraní API pro export nejvyšší úrovně. K volání HTTP musíte použít microsoft Graph API. Microsoft Graph je webové rozhraní RESTful API, které umožňuje přístup k prostředkům cloudové služby Microsoftu.

Poznámka

Informace o volání rozhraní REST API, včetně nástrojů pro interakci s Microsoft Graphem, najdete v tématu Použití microsoftu Graph API.

Microsoft Intune exportuje sestavy pomocí následujícího koncového bodu Microsoft Graph API:

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

Příklad žádosti a odpovědi na sestavu zařízení

Při vytváření požadavku musíte jako součást textu požadavku zadat reportName parametr založený na sestavě, kterou chcete exportovat. Níže je příklad žádosti o export pro sestavu Zařízení . V požadavku musíte použít metodu POST HTTP. Metoda POST se používá k vytvoření nového prostředku nebo provedení akce.

Příklad požadavku

Následující požadavek obsahuje metodu HTTP použitou v požadavku na Microsoft Graph.

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

Poznámka

Pokud chcete načíst data, vyberte konkrétní sloupce, například sloupce zadané ve výše uvedeném příkladu. Nevystavujte automatizaci kolem výchozích sloupců žádného exportu sestavy. Automatizaci byste měli sestavit tak, aby explicitně vybrala relevantní sloupce.

Příklad odpovědi

Na základě výše uvedeného požadavku POST vrátí Graph zprávu odpovědi. Zpráva odpovědi jsou data, která jste požadovali, nebo výsledek operace.

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

Pomocí pole pak můžete dotazovat id stav exportu pomocí požadavku GET:

Příklad: https://graph.microsoft.com/beta/deviceManagement/reports/exportJobs('Devices_05e62361-783b-4cec-b635-0aed0ecf14a3')

Tuto adresu URL budete muset dál volat, dokud nedostanete odpověď s atributem status: completed . Bude vypadat jako v následujícím příkladu:

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

Komprimovaný soubor CSV si pak můžete přímo stáhnout z url pole.

Parametry sestavy

V textu požadavku můžete odeslat pět hlavních parametrů, které definují požadavek na export:

  • reportName:Požadované. Tento parametr je název sestavy, kterou chcete zadat.
  • filter: Nevyžaduje se pro většinu sestav. Všimněte si, že parametrem filtru je řetězec.
  • select: Není povinné. Určete, které sloupce ze sestavy chcete použít. Budou přijaty pouze platné názvy sloupců relevantní pro sestavu, kterou voláte.
  • format: Není povinné. Ve výchozím nastavení jsou data ve csv formátu. Zadejte json výstup souboru ve formátu JSON.
  • localizationType: Tento parametr řídí lokalizační chování sestavy. Možné hodnoty jsou LocalizedValuesAsAdditionalColumn a ReplaceLocalizableValues.

Chování lokalizace

Parametr localizationType řídí lokalizační chování sestavy. Možné hodnoty tohoto parametru jsou LocalizedValuesAsAdditionalColumn a ReplaceLocalizableValues.

Hodnota sestavy LocalizedValuesAsAdditionalColumn

Tato hodnota parametru localizationType je výchozí hodnotou. Pokud parametr není zadaný, vloží se automaticky localizationType . Tato hodnota určuje, že Intune poskytuje dva sloupce pro každý lokalizovatelný sloupec.

  • hodnota výčtu: Sloupec hodnot výčtu obsahuje buď nezpracovaný řetězec, nebo sadu čísel, která se nemění, bez ohledu na národní prostředí. Tento sloupec bude pod původním názvem sloupce (viz příklad).
  • lokalizovaná řetězcová hodnota: Tento sloupec bude původním názvem sloupce s připojeným _loc. Bude obsahovat řetězcové hodnoty, které jsou čitelné pro člověka a podmíněné národní prostředí (viz příklad).

Příklad

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

Nahradit hodnotu sestavyLocalizableValues

Hodnota sestavy ReplaceLocalizableValues vrátí pouze jeden sloupec pro každý lokalizovaný atribut. Tento sloupec bude obsahovat původní název sloupce s lokalizovanými hodnotami.

Příklad

OS
Windows
Windows
Windows
iOS
Android
Mac

U sloupců bez lokalizovaných hodnot se vrátí pouze jeden sloupec s pravým názvem sloupce a hodnotami sloupce true.

Důležité

Parametr localizationType je s několika výjimkami relevantní pro všechna prostředí exportu hostovaná infrastrukturou sestav Intune. TypyDevices sestav a DevicesWithInventory nebudou localizationType respektovat parametr kvůli starším požadavkům na kompatibilitu.

Další kroky