Endpoint dell'API data warehouse di IntuneIntune Data Warehouse API endpoint

È possibile usare l'API data warehouse di Intune con un account con credenziali di Azure AD e controlli di accesso basati sui ruoli specifici.You can use the Intune Data Warehouse API with an account with specific role-based access controls and Azure AD credentials. Sarà quindi possibile autorizzare il client REST con Azure AD usando OAuth 2.0.You will then authorize your REST client with Azure AD using OAuth 2.0. E, infine, si formerà un URL significativo per chiamare una risorsa del data warehouse.And finally, you will form a meaningful URL to call a data warehouse resource.

Requisiti delle credenziali di Azure AD e IntuneAzure AD and Intune credential requirements

L'autenticazione e l'autorizzazione si basano sulle credenziali di Azure AD e sul controllo degli accessi in base al ruolo di Intune (RBAC).Authentication and authorization are based on Azure AD credentials and Intune role-based access control (RBAC). Tutti gli amministratori globali e gli amministratori del servizio Intune per il tenant hanno accesso all'API per impostazione predefinita.All global administrators and Intune service administrators for your tenant have access to the API by default. Usare i ruoli di Intune per fornire accesso per più utenti, offrendo loro l'accesso alla risorsa di creazione report.Use Intune roles to provide access for more users by giving them access to the Reporting resource.

I requisiti per l'accesso all'API sono:Requirements for accessing the API are:

  • Licenza di Intune assegnata all'utenteIntune license must be assigned to the user
  • L'utente deve essere uno dei seguenti:User must be one of:
    • Amministratore globale di Azure ADAzure AD global administrator
    • Amministratore del servizio IntuneAn Intune service administrator
    • Utente con accesso basato sui ruoli alla risorsa ReportUser with role-based access to Reports resource

AutorizzazioneAuthorization

In Azure Active Directory (Azure AD) si utilizza OAuth 2.0 per consentire all'utente di autorizzare l'accesso ad applicazioni Web e API Web nel proprio tenant di Azure AD.Azure Active Directory (Azure AD) uses OAuth 2.0 to enable you to authorize access to web applications and web APIs in your Azure AD tenant. Questa guida è indipendente dal linguaggio e descrive come inviare e ricevere messaggi HTTP senza usare alcuna libreria open source.This guide is language independent, and describes how to send and receive HTTP messages without using any of our open-source libraries. Il flusso del codice di autorizzazione OAuth 2.0 è descritto nella sezione 4.1 della specifica OAuth 2.0.The OAuth 2.0 authorization code flow is described in section 4.1 of the OAuth 2.0 specification.

Per altre informazioni, vedere Autorizzare l'accesso alle applicazioni Web tramite OAuth 2.0 e Azure Active Directory.For more information, see Authorize access to web applications using OAuth 2.0 and Azure Active Directory.

Struttura URL APIAPI URL structure

Gli endpoint dell'API data warehouse leggono le entità per ogni set.The Data Warehouse API endpoints read the entities for each set. L'API supporta un verbo HTTP GET e un subset di opzioni di query.The API supports a GET HTTP verb, and a subset of query options.

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

L'URL contiene gli elementi seguenti:The URL contains the following elements:

ElementoElement EsempioExample DescrizioneDescription
locationlocation msua06msua06 L'URL di base è reperibile visualizzando il pannello dell'API data warehouse nel portale di Azure.The base URL can be found by viewing the Data Warehouse API blade in the Azure portal.
entity-collectionentity-collection datesdates Il nome della raccolta di entità OData.The name of the OData entity collection. Per altre informazioni sulle raccolte e sulle entità nel modello di dati, vedere Modello di dati.For more information on collections and entities in the data model, see Data Model.
api-versionapi-version betabeta Si intende la versione dell'API a cui accedere.Version is the version of the API to access. Per altre informazioni, vedere Versione.For more information, see Version.

Informazioni sulla versione dell'APIAPI version information

La versione corrente delle API è: beta.The current version of the API is: beta.

Opzioni di query ODataOData query options

La versione corrente supporta i parametri di query OData seguenti: $skip, $top, $filter, $orderby.The current version supports the following OData query parameters: $skip, $top, $filter, $orderby.