Graph API'lerini Kullanarak Intune Raporlarını Dışarı Aktarma

Intune raporlama altyapısına geçirilen tüm raporlar tek bir üst düzey dışarı aktarma API'sinden dışarı aktarılabilir. HTTP çağrısı yapmak için Microsoft Graph API kullanmanız gerekir. Microsoft Graph, Microsoft Bulut hizmeti kaynaklarına erişmenizi sağlayan bir RESTful web API'dir.

Not

Microsoft Graph ile etkileşime yönelik araçlar da dahil olmak üzere REST API çağrıları yapma hakkında bilgi için bkz. Microsoft Graph API kullanma.

Microsoft Intune aşağıdaki Microsoft Graph API uç noktasını kullanarak raporları dışarı aktarır:

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

Örnek cihazlar rapor isteği ve yanıtı

İsteği yaparken, dışarı aktarmak istediğiniz raporu temel alarak istek gövdesinin bir parçası olarak bir reportName parametre sağlamanız gerekir. Aşağıda Cihazlar raporu için dışarı aktarma isteği örneği verilmiştir. İsteğinizde POST HTTP yöntemini kullanmanız gerekir. POST yöntemi, yeni bir kaynak oluşturmak veya eylem gerçekleştirmek için kullanılır.

İstek örneği

Aşağıdaki istek, Microsoft Graph isteğinde kullanılan HTTP yöntemini içerir.

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

Not

Verileri almak için, yukarıdaki örnekte belirtilenler gibi belirli sütunları seçin. Herhangi bir rapor dışarı aktarma işleminin varsayılan sütunları etrafında otomasyon oluşturmayın. İlgili sütunları açıkça seçmek için otomasyonunuzu oluşturmanız gerekir.

Yanıt örneği

Yukarıdaki POST isteğine bağlı olarak Graph bir yanıt iletisi döndürür. Yanıt iletisi, istediğiniz veriler veya işlemin sonucudur.

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

Daha sonra, get isteğiyle dışarı aktarmanın durumunu sorgulamak için alanını kullanabilirsiniz id :

Örneğin: https://graph.microsoft.com/beta/deviceManagement/reports/exportJobs('Devices_05e62361-783b-4cec-b635-0aed0ecf14a3') veya https://graph.microsoft.com/beta/deviceManagement/reports/exportJobs/Devices_05e62361-783b-4cec-b635-0aed0ecf14a3

Özniteliği olan status: completed bir yanıt alıncaya kadar bu URL'yi çağırmaya devam etmeniz gerekir. Aşağıdaki örneğe benzer:

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

Ardından sıkıştırılmış CSV'yi doğrudan alandan url indirebilirsiniz.

Rapor parametreleri

Dışarı aktarma isteğini tanımlamak için istek gövdesinde gönderebileceğiniz beş ana parametre vardır:

  • reportName:Gerekli. Bu parametre, belirtmek istediğiniz raporun adıdır.
  • filter: Çoğu rapor için gerekli değildir. Filtre parametresi bir dizedir.
  • select: Gerekli değildir. Rapordan hangi sütunları istediğinizi belirtin. Yalnızca aradığınız raporla ilgili geçerli sütun adları kabul edilir.
  • format: Gerekli değildir. Varsayılan olarak, veriler biçiminde çıkıştır csv . Dosyanın JSON biçiminde çıkışını almak için belirtin json .
  • localizationType: Bu parametre rapor için yerelleştirme davranışını denetler. Olası değerler ve ReplaceLocalizableValuesşeklindedirLocalizedValuesAsAdditionalColumn.

Yerelleştirme davranışı

localizationType parametresi, rapor için yerelleştirme davranışını denetler. Bu parametrenin olası değerleri ve ReplaceLocalizableValues'tirLocalizedValuesAsAdditionalColumn.

LocalizedValuesAsAdditionalColumn rapor değeri

Parametresi için bu localizationType değer varsayılan değerdir. Parametre belirtilmezse localizationType otomatik olarak eklenir. Bu değer, Intune her yerelleştirilebilir sütun için iki sütun sağladığını belirtir.

  • enum değeri: Sabit listesi değeri sütunu, yerel ayardan bağımsız olarak bir ham dize veya değişmeyen bir sayı kümesi içerir. Bu sütun özgün sütun adının altındadır (örne bakın).
  • yerelleştirilmiş dize değeri: Bu sütun, _loc eklenmiş özgün sütun adıdır. İnsan tarafından okunabilir dize değerleri ve yerel ayar koşullu değerleri içerir (örne bakın).

Örnek

İşletim sistemi OS_loc
1 Windows
1 Windows
1 Windows
2 iOS
3 Android
4 Mac

ReplaceLocalizableValues rapor değeri

ReplaceLocalizableValues rapor değeri, yerelleştirilmiş öznitelik başına yalnızca bir sütun döndürür. Bu sütun, yerelleştirilmiş değerleri içeren özgün sütun adını içerir.

Örnek

İşletim sistemi
Windows
Windows
Windows
iOS
Android
Mac

Yerelleştirilmiş değerleri olmayan sütunlar için, yalnızca gerçek sütun adına ve gerçek sütun değerlerine sahip tek bir sütun döndürülür.

Önemli

localizationType parametresi, birkaç özel durum dışında Intune raporlama altyapısı tarafından barındırılan tüm dışarı aktarma deneyimleri için geçerlidir. Devices ve DevicesWithInventory rapor türleri, eski uyumluluk gereksinimleri nedeniyle parametreye localizationType uymaz.

API azaltma koşulları

API'nin yanıt hızını etkileyecek çok fazla eşzamanlı istek olmadığından emin olmak exportJobs için aşağıdaki azaltma sınırları uygulanır.

  • API'ler kiracı başına dakikada en fazla 100 isteği destekler: Bu destek, kiracıdaki tüm kullanıcıları ve uygulamaları kapsar. Aynı dakika içinde kiracıdaki kullanıcılar veya uygulamalar tarafından başlatılan ek istekler kısıtlanır.
    • API'ler bir kullanıcı tarafından başlatılırsa, bir dakika içinde aynı kullanıcı tarafından en fazla 8 isteğe izin verilir. Aynı kullanıcı tarafından aynı dakika içinde yapılan sonraki istekler kısıtlanır.
    • API'ler bir uygulama tarafından başlatılırsa, bir dakika içinde aynı uygulama tarafından en fazla 48 isteğe izin verilir. Aynı uygulama tarafından aynı dakika içinde yapılan sonraki istekler kısıtlanır.

Sonraki adımlar

  • Last updated on