Export Intune sestav pomocí rozhraní API Graph

Všechny sestavy migrované do infrastruktury generování sestav Intune budou k dispozici pro export z jednoho rozhraní API pro export nejvyšší úrovně. K volání HTTP musíte použít microsoftový 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 Graph, najdete v tématu Použití microsoft Graph API.

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

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

Příklad požadavku a odpovědi na sestavu zařízení

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

Příklad požadavku

Následující požadavek obsahuje metodu HTTP použitou pro požadavek microsoft Graph.

{ 
    "reportName": "Devices", 
    "filter":"(OwnerType eq '1')", 
    "localizationType": "LocalizedValuesAsAdditionalColumn", 
    "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é v předchozím příkladu. Nevytvářejte automatizaci kolem výchozích sloupců exportu sestavy. Měli byste vytvořit automatizaci, abyste explicitně vybrali relevantní sloupce.

Příklad odpovědi

Na základě výše uvedeného požadavku POST Graph vrátí zprávu odpovědi. Zpráva odpovědi jsou data, která jste si vyžádali, 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" 
} 

Potom můžete pomocí pole id zadat dotaz na stav exportu pomocí požadavku GET:

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

Budete muset pokračovat ve volání této adresy URL, 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ý sdílený svazek clusteru si pak můžete z pole url stáhnout přímo.

Parametry sestavy

Existují čtyři hlavní parametry, které můžete odeslat v textu požadavku a definovat požadavek na export:

  • reportName: Povinné. Tento parametr je název sestavy, kterou chcete zadat.
  • filter: U většiny sestav se nevyžaduje. Všimněte si, že parametr filtru je řetězec.
  • select: Nevyžaduje se. Určete, které sloupce ze sestavy chcete mít. Budou přijaty pouze platné názvy sloupců, které jsou relevantní pro sestavu, kterou voláte.
  • localizationType: Tento parametr řídí chování lokalizace sestavy. Možné hodnoty jsou LocalizedValuesAsAdditionalColumn a ReplaceLocalizableValues.

Chování lokalizace

Parametr localizationType řídí chování lokalizace sestavy. Možné hodnoty pro tento parametr jsou LocalizedValuesAsAdditionalColumn a ReplaceLocalizableValues.

Hodnota sestavy LocalizedValuesAsAdditionalColumn

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

  • Hodnota výčtu: Sloupec hodnot výčtu obsahuje buď nezpracovanou hodnotu, nebo sadu čísel, která se nemění, bez ohledu na národní prostředí. Tento sloupec bude pod názvem původního sloupce (viz příklad).
  • lokalizovaná řetězcová hodnota: Tento sloupec bude původní název 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

Hodnota sestavy ReplaceLocalizableValues

Hodnota sestavy ReplaceLocalizableValues vrátí pouze jeden sloupec na 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 skutečnými hodnotami sloupce.

Důležité

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

Další kroky