Aracılığıyla paylaş

Microsoft Intune Data Warehouse API

  • Makale

Intune Data Warehouse API'si, Intune verilerinize sık kullandığınız analiz aracında kullanmak üzere makine tarafından okunabilir bir biçimde erişmenizi sağlar. API'yi kullanarak kurumsal mobil ortamınız hakkında içgörü sağlayan raporlar oluşturabilirsiniz. API, aşağıdakiler için standart desenleri izleyen OData protokollerini kullanır:

  • İstek ve yanıt üst bilgileri
  • Durum kodları
  • HTTP yöntemleri
  • URL kuralları
  • Medya türleri
  • Yük biçimleri
  • Sorgu seçenekleri

OData (Açık Veri Protokolü), RESTful API'leri oluşturmak ve tüketmek için en iyi yöntemi tanımlayan Yapılandırılmış Bilgi Standartlarının (OASIS) İlerletilmesine yönelik bir Kuruluşdur. Intune Data Warehouse OData sürüm 4.0 kullanır.

Bu başvuru bölümünde uç noktalara, desteklenen HTTP yöntemlerine, dönüş yükü biçimlerine ve Intune Data Warehouse veri modelinin belgelerine genel bir bakış sağlanır.

Önemli

Beta sürümünü kullanarak Data Warehouse en son işlevselliğini deneyebilirsiniz. Beta sürümünü kullanmak için URL'nizin sorgu parametresini api-version=betaiçermesi gerekir. Beta sürümü, desteklenen bir hizmet olarak genel kullanıma sunulmadan önce özellikler sunar. Intune yeni özellikler ekledikçe beta sürümü davranışı ve veri sözleşmelerini değiştirebilir. Beta sürümüne bağımlı olan tüm özel kodlar veya raporlama araçları devam eden güncelleştirmelerle bozulabilir.

OData özel istemcisi

Intune Data Warehouse veri modeline RESTful uç noktaları üzerinden erişebilirsiniz. Verilerinize erişim kazanmak için istemcinizin OAuth 2.0 kullanarak Microsoft Entra ID yetkilendirmesi gerekir. İlk olarak Azure'da bir web uygulaması ve bir istemci uygulaması ayarladınız, istemciye izinler verin. Yerel istemciniz yetkilendirme alır ve ardından Data Warehouse uç noktalarıyla iletişim kurabilir.

Daha fazla bilgi için bkz. REST istemcisiyle Data Warehouse API'sinden veri alma.

Not

Kod örnekleri için GitHub'daki GitHub Intune Data Warehouse deposuna erişebilirsiniz.

API ile etkileşim kurma

API, Microsoft Entra ID ile yetkilendirme gerektirir. Microsoft Entra ID OAuth 2.0 kullanır. Yetkilendirildikten sonra, HTTP GET fiilini kullanarak ve kullanıma sunulan varlık koleksiyonları ile iletişim kurarak API'den veri alabilirsiniz. Ayrıntılar için bkz.

Intune Data Warehouse veri modeli

OData, bir soyut veri modeli ve herhangi bir istemcinin herhangi bir veri kaynağı tarafından kullanıma sunulan bilgilere erişmesine izin veren bir protokol tanımlar. Veri modeli belgeleri konusu, Intune Data Warehouse veri modelindeki ad alanlarının, varlıkların ve dönüş nesnelerinin açıklamasını içerir. Daha fazla bilgi için bkz. Data Warehouse Veri Modeli.

Sonraki adımlar

Microsoft Entra ID için Kimlik Doğrulama Senaryoları'nı okuyarak Microsoft Entra ID ile çalışma hakkında daha fazla bilgi edinin.

odata.org konumunda OData kaynaklarını bulun.

OData Sürüm 4.0'da OData Sürüm 4.0 standardını gözden geçirin.