api uç noktasını Intune Data Warehouse

Intune Data Warehouse API'sini belirli rol tabanlı erişim denetimlerine ve Microsoft Entra kimlik bilgilerine sahip bir hesapla kullanabilirsiniz. Ardından OAuth 2.0 kullanarak REST istemcinizi Microsoft Entra ID ile yetki vereceksiniz. Son olarak, veri ambarı kaynağını çağırmak için anlamlı bir URL oluşturacaksınız.

kimlik bilgileri gereksinimlerini Microsoft Entra ID ve Intune

Kimlik doğrulaması ve yetkilendirme, Microsoft Entra kimlik bilgilerini ve Intune rol tabanlı erişim denetimini (RBAC) temel alır. Kiracınızın tüm Intune Yöneticileri varsayılan olarak Veri ambarı'na erişebilir. Daha fazla kullanıcıya Intune veri ambarı kaynağına erişim vererek erişim sağlamak için Intune rollerini kullanın.

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

• Kullanıcının aşağıdaki rollerden en az birine sahip olması gerekir:
  • Intune hizmet yöneticisi
  • Intune veri ambarı kaynağına rol tabanlı erişimi olan kullanıcı
  • Yalnızca uygulama kimlik doğrulaması kullanarak kullanıcısız kimlik doğrulaması

Önemli

Intune rolüne atanmak ve Intune Data Warehouse erişmek için kullanıcının Intune lisansına sahip olması gerekir. Daha fazla bilgi için bkz. Microsoft Intune ve Microsoft Intune lisanslama ile rol tabanlı erişim denetimi (RBAC).

Yetkilendirme

Microsoft Entra ID, Microsoft 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 açık kaynak kitaplıkları kullanmadan HTTP iletileri göndermeyi ve almayı 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 bkz. OAuth 2.0 ve Microsoft Entra ID kullanarak web uygulamalarına erişimi yetkilendirme.

API URL yapısı

Data Warehouse API uç noktaları her kümenin varlıklarını okur. API, 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 , ve {api-version} değerlerini aşağıdaki tabloda sağlanan ayrıntılara göre değiştirin.{location}{entity-collection}

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

Öğe	Örnek	Açıklama
Konum	msua06	Temel URL,Microsoft Intune yönetim merkezinde Data Warehouse API dikey penceresi görüntülenerek bulunabilir.
entity-collection	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, erişecek API'nin sürümüdür. Daha fazla bilgi için bkz. Sürüm.
maxhistorydays	7	(İsteğe bağlı) Alınacak en fazla geçmiş günü sayısı. Bu parametre herhangi bir koleksiyona sağlanabilir, ancak yalnızca anahtar özelliğinin bir parçası olarak içeren dateKey koleksiyonlar için geçerli olur. Daha fazla bilgi için bkz. DateKey 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 koleksiyonlara Güncelleştirmeler, doğası gereği ek niteliğindedir ve mevcut senaryoları bozmaz.

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 sorgu seçenekleri

Geçerli sürüm şu OData sorgu parametrelerini destekler: $filter, $selectve $skip,$top. içinde $filter, yalnızca DateKey sütunlar geçerli olduğunda veya RowLastModifiedDateTimeUTC desteklenebilir ve diğer özellikler hatalı bir istek tetikleyebilir.

DateKey Aralık Filtreleri

DateKey aralık filtreleri, anahtar özelliği olan 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ı iyileştirmek için kullanılabilir:

1. DateKey tek başına içinde $filterişleçleri destekler lt/le/eq/ge/gt ve mantıksal işleçle andbirleşir; burada başlangıç tarihi ve/veya bitiş tarihiyle eşlenebilirler.
2. maxhistorydays özel sorgu seçeneği olarak sağlanır.
   

Filtre örnekleri

Not

Filtre örnekleri bugün 21/21/2018 olduğunu varsayar.

Filtrele	Performans İyileştirme	Açıklama
maxhistorydays=7	Tam	ile 20180214 ile 20180221 arasında veri DateKey döndürme.
$filter=DateKey eq 20180214	Tam	20180214 eşit olan DateKey verileri döndürür.
$filter=DateKey ge 20180214 and DateKey lt 20180221	Tam	ile 20180214 ile 20180220 arasında veri DateKey döndürme.
maxhistorydays=7&$filter=DateKey eq 20180214	Tam	20180214 eşit olan DateKey verileri döndürür. maxhistorydays yoksayılır.
$filter=RowLastModifiedDateTimeUTC ge 2018-02-21T23:18:51.3277273Z	Tam	ile veri RowLastModifiedDateTimeUTC döndürme büyüktür veya eşittir 2018-02-21T23:18:51.3277273Z