Endpoint dell’API Data warehouse di Intune

Articolo
12/21/2023

È possibile usare l'API Data Warehouse di Intune con un account con controlli di accesso specifici in base al ruolo e credenziali di 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 per ID Microsoft Entra e credenziali di Intune

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

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

L'utente deve essere uno dei seguenti:
- amministratore globale Microsoft Entra
- Amministratore del servizio Intune
- Utente con accesso in base al ruolo alla risorsa data warehouse di Intune
- Autenticazione senza utente che usa l'autenticazione solo applicazione

Importante

Per avere un ruolo in Intune e accedere alla Data Warehouse di Intune, l'utente deve avere una licenza di Intune. Per altre informazioni, vedere Controllo degli accessi in base al ruolo con Microsoft Intune e licenze Microsoft Intune.

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 usando 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}

Nota

Nell'URL precedente sostituire {location}, {entity-collection}e {api-version} in base ai dettagli forniti nella tabella seguente.

L'URL contiene gli elementi seguenti:

Elemento	Esempio	Descrizione
posizione	msua06	L'URL di base è disponibile visualizzando il pannello API Data Warehouse nell'interfaccia di amministrazione Microsoft Intune.
entity-collection	devicePropertyHistories	Nome della raccolta di entità OData. Per altre informazioni su raccolte ed entità nel modello di dati, vedere Modello di dati.
api-version	Beta	La versione è la versione dell'API a cui accedere. Per altre informazioni, vedere Versione.
maxhistorydays	7	(Facoltativo) Numero massimo di giorni di cronologia da recuperare. Questo parametro può essere fornito a qualsiasi raccolta, ma avrà effetto solo per le raccolte che includono `dateKey` come parte della relativa proprietà della chiave. Per altre informazioni , vedere Filtri di intervallo DateKey .

Informazioni sulla versione dell'API

È ora possibile usare la versione v1.0 del Data Warehouse di Intune 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 :

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.
maxhistorydays viene fornito come opzione di query personalizzata.

Esempi di filtri