Endpoint dell’API Data warehouse di Intune

È possibile usare l'API Intune Data Warehouse con un account con controlli di accesso specifici in base al ruolo e credenziali Microsoft Entra. Si autorizzerà quindi il client REST con Microsoft Entra ID usando OAuth 2.0. Infine, si formerà un URL significativo per chiamare una risorsa del data warehouse.

requisiti delle credenziali di Microsoft Entra ID e Intune

L'autenticazione e l'autorizzazione si basano sulle credenziali Microsoft Entra e Intune controllo degli accessi in base al ruolo. Tutti gli amministratori globali e gli amministratori del servizio Intune per il tenant hanno accesso al data warehouse per impostazione predefinita. Usare Intune ruoli per fornire l'accesso a un maggior numero di utenti concedendole l'accesso alla risorsa del data warehouse Intune.

I requisiti per l'accesso al Intune Data Warehouse (inclusa l'API) sono:

• L'utente deve avere almeno uno dei ruoli seguenti:
  • Amministratore del servizio Intune
  • Utente con accesso in base al ruolo alla risorsa Intune data warehouse
  • Autenticazione senza utente che usa l'autenticazione solo applicazione

Autorizzazione

Microsoft Entra ID usa OAuth 2.0 per consentire di autorizzare l'accesso ad applicazioni Web e API Web nel tenant Microsoft Entra. Questa guida è indipendente dal linguaggio e descrive come inviare e ricevere messaggi HTTP senza usare librerie open source. Il flusso del codice di autorizzazione OAuth 2.0 è descritto nella sezione 4.1 della specifica OAuth 2.0.

Per altre informazioni, vedere Autorizzare l'accesso alle applicazioni Web tramite OAuth 2.0 e Microsoft Entra ID.

Struttura dell'URL dell'API

Gli endpoint API Data Warehouse leggono le entità per ogni set. L'API supporta un verbo HTTP GET e un subset di opzioni di query.

L'URL per Intune usa il formato seguente:
https://fef.{location}.manage.microsoft.com/ReportingService/DataWarehouseFEService/{entity-collection}?api-version={api-version}

L'URL contiene gli elementi seguenti:

Informazioni sulla versione dell'API

È ora possibile usare la versione v1.0 del Intune Data Warehouse impostando il parametro api-version=v1.0di query . Aggiornamenti alle raccolte nel Data Warehouse sono di natura additive e non interrompono gli scenari esistenti.

È possibile provare le funzionalità più recenti del Data Warehouse usando la versione beta. Per usare la versione beta, l'URL deve contenere il parametro api-version=betadi query . La versione beta offre funzionalità prima che vengano rese disponibili a livello generale come servizio supportato. Quando Intune aggiunge nuove funzionalità, la versione beta può modificare il comportamento e i contratti dati. Qualsiasi codice personalizzato o strumento di creazione di report dipendente dalla versione beta potrebbe interrompersi con gli aggiornamenti in corso.

Opzioni di query OData

La versione corrente supporta i parametri di query OData seguenti: $filter, $skip,$selecte $top. In $filter, solo DateKey o RowLastModifiedDateTimeUTC può essere supportato quando le colonne sono applicabili e altre proprietà attivano una richiesta non valida.

Filtri di intervallo DateKey

DateKey I filtri di intervallo possono essere usati per limitare la quantità di dati da scaricare per alcune raccolte con dateKey come proprietà chiave. Il DateKey filtro può essere usato per ottimizzare le prestazioni del servizio fornendo il parametro di query seguente $filter :

1. DateKey $filterin , supportando gli lt/le/eq/ge/gt operatori e unendo con l'operatore andlogico , in cui è possibile eseguire il mapping a una data di inizio e/o fine.
2. maxhistorydays viene fornito come opzione di query personalizzata.
   

Esempi di filtri