Intune Data Warehouse API Uç Noktası

Intune Data Warehouse API'yi belirli rol tabanlı erişim denetimlerine ve Microsoft Entra kimlik bilgilerine sahip bir hesapla kullanabilirsiniz. Daha sonra REST istemcinizi OAuth 2.0 kullanarak Microsoft Entra IDMicrosoft Entra ID ile yetkilendireceksiniz. Ve son olarak, bir veri ambarı kaynağını çağırmak için anlamlı bir URL oluşturacaksınız.

Microsoft Entra IDMicrosoft Entra ID ve IntuneIntune credential requirements

Kimlik doğrulama ve yetkilendirme, Microsoft Entra kimlik bilgilerini ve Intune rol tabanlı erişim denetimini (RBAC) temel alır. All IntuneIntune Kiracınızın yöneticilerinin varsayılan olarak Veri ambarına erişimi vardır. Daha fazla kullanıcıya erişim sağlamak için IntuneIntune rollerini kullanın ve onlara IntuneIntune veri ambarı kaynağına erişim verin.

Intune Data Warehouse erişme gereksinimleri (API dahil) şunlardır:

Önemli

Kullanıcının Intune rolüne atanabilmesi ve Intune Data Warehouse erişebilmesi için Intune lisansı olmalıdır. Daha fazla bilgi için bkz. Role-based access control (RBAC) with Microsoft IntuneMicrosoft Intune ve Microsoft IntuneMicrosoft Intune licensing.

Yetkilendirme

Microsoft Entra IDMicrosoft Entra ID, Microsoft EntraMicrosoft Entra kiracınızdaki web uygulamalarına ve web API'lerine erişimi yetkilendirmenizi sağlamak için OAuth 2.0'ı kullanır. Bu kılavuz dilden bağımsızdır ve herhangi bir açık kaynak kitaplığı kullanmadan HTTP iletilerinin nasıl gönderilip alınacağını açıklar. OAuth 2.0 yetkilendirme kodu akışı, OAuth 2.0 belirtiminin 4.1 bölümünde açıklanmıştır.

Daha fazla bilgi için OAuth 2.0 ve Microsoft Entra ID kullanarak web uygulamalarına erişimi yetkilendirme başlıklı makaleyi inceleyin.

API URL yapısı

Data Warehouse API uç noktaları, her kümenin varlıklarını okur. API, bir GET HTTP fiilini ve sorgu seçeneklerinin bir alt kümesini destekler.

Intune URL'si aşağıdaki biçimi kullanır:https://fef.{location}.manage.microsoft.com/ReportingService/DataWarehouseFEService/{entity-collection}?api-version={api-version}

Not

Yukarıdaki URL'de, , , {api-version} öğesini aşağıdaki tabloda verilen ayrıntılara göre değiştirin.{location}{entity-collection}

URL aşağıdaki öğeleri içerir:

Eleman Örnek Açıklama
Konum msua06 Temel URL, Microsoft IntuneMicrosoft Intune yönetim merkezinde Data WarehouseData Warehouse API dikey penceresi görüntülenerek bulunabilir.
varlık koleksiyonu devicePropertyHistories OData varlık koleksiyonunun adı. Veri modelindeki koleksiyonlar ve varlıklar hakkında daha fazla bilgi için bkz: Veri Modeli.
api sürümü beta sürümü version, erişilecek API sürümüdür. Daha fazla bilgi için Sürüm konusuna bakın.
MAKTARİHGÜNGÜNÜ işlevi 7 (İsteğe bağlı) Geçmişi almak için en fazla gün sayısı. Bu parametre herhangi bir koleksiyona sağlanabilir, ancak yalnızca anahtar özelliklerinin bir parçası olarak içeren dateKey koleksiyonlar için geçerli olur. Daha fazla bilgi için bkz. Tarih Tuşu Aralık Filtreleri .

API sürümü bilgileri

Artık sorgu parametresini api-version=v1.0ayarlayarak Intune Data Warehouse v1.0 sürümünü kullanabilirsiniz. Data Warehouse'teki koleksiyonlara Güncelleştirmeler, doğaları gereği katkı özelliğine sahiptir ve mevcut senaryoları bozmaz.

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

OData sorgu seçenekleri

Geçerli sürüm aşağıdaki OData sorgu parametrelerini destekler: $filter, $select, $skip, ve $top. In $filter, yalnızca DateKey veya RowLastModifiedDateTimeUTC sütunlar uygulanabilir olduğunda desteklenebilir ve diğer özellikler hatalı bir isteği tetikleyebilir.

Tarih Tuşu Aralık Filtreleri

DateKey Aralık filtreleri, anahtar özelliği olarak bazı koleksiyonlar dateKey için indirilecek veri miktarını sınırlamak için kullanılabilir. Filtre DateKey , aşağıdaki $filter sorgu parametresini sağlayarak hizmet performansını en iyi duruma getirmek için kullanılabilir:

  1. DateKey tek başına $filter, operatörleri desteklemek lt/le/eq/ge/gt ve bir başlangıç tarihi ve/veya bitiş tarihine eşlenebilecekleri mantık operatörü andile birleştirmek.
  2. maxhistorydays özel sorgu seçeneği olarak sunulur.

Filtre örnekleri

Not

Filtre örneklerinde bugünün 21.02.2018 olduğu varsayılmaktadır.

Filtrele Performans Optimizasyonu Açıklama
maxhistorydays=7 Tam Dolu 20180214 ile 20180221 arasındaki verileri DateKey döndürün.
$filter=DateKey eq 20180214 Tam Dolu 20180214'e eşit olan DateKey verileri döndürür.
$filter=DateKey ge 20180214 and DateKey lt 20180221 Tam Dolu 20180214 ile 20180220 arasındaki verileri DateKey döndürün.
maxhistorydays=7&$filter=DateKey eq 20180214 Tam Dolu 20180214'e eşit olan DateKey verileri döndürür. maxhistorydays olarak yoksayılır.
$filter=RowLastModifiedDateTimeUTC ge 2018-02-21T23:18:51.3277273Z Tam Dolu Şu değerden büyük veya eşitken RowLastModifiedDateTimeUTC veri döndürülür 2018-02-21T23:18:51.3277273Z
  • Last updated on