Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
Intune raporlama altyapısına geçirilen tüm raporlar, tek bir üst düzey dışa aktarma API'sinden dışa aktarılabilir. HTTP çağrısını yapmak için Microsoft Graph APIGraph API kullanmanız gerekir. Microsoft Graph, Microsoft Bulut hizmeti kaynaklarına erişmenizi sağlayan bir RESTful web API'sidir.
Not
Microsoft Graph ile etkileşim araçları da dahil olmak üzere REST API çağrıları yapma hakkında bilgi için Graph API bkz.
Microsoft IntuneMicrosoft Intune, aşağıdaki Microsoft Graph APIGraph 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ı
İstekte bulunurken, dışa aktarmak istediğiniz rapora dayalı olarak istek gövdesinin bir parçası olarak bir reportName parametre sağlamanız gerekir. Aşağıda, Cihazlar raporu için bir 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 bir 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çermektedir.
{
"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. Otomasyonu, herhangi bir rapor dışarı aktarma işleminin varsayılan sütunları etrafında 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 bu alanı kullanarak id bir GET isteğiyle dışarı aktarma işleminin durumunu sorgulayabilirsiniz:
Ö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
Öznitelik içeren status: completed bir yanıt alana kadar bu URL'yi çağırmaya devam etmeniz gerekir. Aşağıdaki örnek gibi görünür:
{
"@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"
}
Daha sonra sıkıştırılmış CSV'yi doğrudan sahadan url indirebilirsiniz.
Rapor parametreleri
Dışarı aktarma isteğini tanımlamak için istek gövdenize 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ğil. Rapordan hangi sütunları istediğinizi belirtin. Yalnızca aradığınız raporla ilgili geçerli sütun adları kabul edilir. -
format: Gerekli değil. Varsayılan olarak, verilerin çıkışı biçimde olurcsv. Dosyanın çıktısını JSON biçiminde almayı belirtinjson. -
localizationType: Bu parametre, raporun yerelleştirme davranışını denetler. Olası değerler şunlardır:LocalizedValuesAsAdditionalColumnveReplaceLocalizableValues.
Yerelleştirme davranışı
Parametre localizationType , raporun yerelleştirme davranışını denetler. Bu parametrenin olası değerleri şunlardır: LocalizedValuesAsAdditionalColumn ve ReplaceLocalizableValues.
LocalizedValuesAsAdditionalColumn rapor değeri
Parametrenin localizationType bu değeri varsayılan değerdir. Parametre belirtilmezse otomatik olarak localizationType eklenir. Bu değer, Intune her yerelleştirilebilir sütun için iki sütun sağladığını belirtir.
- enum değeri: Enum değeri sütunu, yerel ayardan bağımsız olarak değişmeyen ham bir dize veya bir dizi sayı içerir. Bu sütun, özgün sütun adının altındadır (örneğe bakın).
- Yerelleştirilmiş dize değeri: Bu sütun, _loc eklenmiş özgün sütun adıdır. İnsan tarafından okunabilen ve yerel ayar koşullu dize değerleri içerir (örneğe 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ğerlerle birlikte özgün sütun adını içerir.
Örnek
| İşletim sistemi |
|---|
| Windows |
| Windows |
| Windows |
| iOS |
| Android |
| Mac |
Yerelleştirilmiş değerler içermeyen sütunlar için, yalnızca doğru sütun adına ve doğru sütun değerlerine sahip tek bir sütun döndürülür.
Önemli
ParametrelocalizationType, birkaç özel durum dışında Intune'un raporlama altyapısı tarafından barındırılan tüm dışarı aktarma deneyimleri için geçerlidir. EskiDevices uyumluluk gereksinimleri nedeniyle ve DevicesWithInventory rapor türleri parametreyi localizationType kabul etmez.
API azaltma koşulları
API'nin, API'nin yanıt oranını etkileyebilecek çok fazla eşzamanlı isteği 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, bir kiracıdaki tüm kullanıcıları ve uygulamaları kapsar. Kiracıdaki kullanıcılar veya uygulamalar tarafından aynı dakika içinde başlatılan tüm ek istekler azaltılır.
- API'ler bir kullanıcı tarafından başlatılırsa, aynı kullanıcı tarafından bir dakika içinde en fazla 8 isteğe izin verilir. Aynı dakika içinde aynı kullanıcı tarafından yapılan müteakip istekler azaltılır.
- API'ler bir uygulama tarafından başlatılırsa, aynı uygulama tarafından bir dakika içinde en fazla 48 isteğe izin verilir. Aynı dakika içinde aynı uygulama tarafından yapılan sonraki istekler azaltılır.