Endpunkt der Intune Data Warehouse-APIIntune Data Warehouse API endpoint

Sie können die Intune-Data Warehouse-API mit einem Konto mit bestimmten rollenbasierten Zugriffssteuerungen und Azure AD-Anmeldeinformationen verwenden.You can use the Intune Data Warehouse API with an account with specific role-based access controls and Azure AD credentials. Anschließend autorisieren Sie Ihren REST-Client mithilfe von OAuth 2.0 für Azure AD.You will then authorize your REST client with Azure AD using OAuth 2.0. Schließlich erstellen Sie eine aussagekräftige URL, um eine Data Warehouse-Ressource aufzurufen.And finally, you will form a meaningful URL to call a data warehouse resource.

Anforderungen an die Anmeldeinformationen für Azure AD und IntuneAzure AD and Intune credential requirements

Authentifizierung und Autorisierung basieren auf Azure AD-Anmeldeinformationen und rollenbasierter Zugriffssteuerung über Intune (RBAC).Authentication and authorization are based on Azure AD credentials and Intune role-based access control (RBAC). Alle globalen Administratoren und Intune-Serviceadministratoren für Ihren Mandanten haben standardmäßig Zugriff auf die API.All global administrators and Intune service administrators for your tenant have access to the API by default. Verwenden Sie Intune-Rollen, um den Zugriff für mehr Benutzer bereitzustellen, indem Sie Ihnen Zugriff auf die Reporting resource (Berichtsressource) gewähren.Use Intune roles to provide access for more users by giving them access to the Reporting resource.

Anforderungen für den Zugriff auf die API sind:Requirements for accessing the API are:

  • Intune-Lizenz muss dem Benutzer zugewiesen seinIntune license must be assigned to the user
  • Benutzer muss eine der folgenden Rollen innehaben:User must be one of:
    • Globaler Azure AD-AdministratorAzure AD global administrator
    • Intune-DienstadministratorAn Intune service administrator
    • Benutzer mit rollenbasiertem Zugriff auf die Ressource Reports (Berichte)User with role-based access to Reports resource

AutorisierungAuthorization

Azure Active Directory (Azure AD) bietet Ihnen über OAuth 2.0 die Möglichkeit, den Zugriff auf Webanwendungen und Web-APIs in Ihrem Azure AD-Mandanten zu autorisieren.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. Dieses Handbuch ist sprachenunabhängig und beschreibt, wie HTTP-Nachrichten gesendet und empfangen werden können, ohne irgendeine unserer Open Source-Bibliotheken zu verwenden.This guide is language independent, and describes how to send and receive HTTP messages without using any of our open-source libraries. Der Codefluss zur Autorisierung mit OAuth 2.0 wird in section 4.1 (Abschnitt 4.1) der OAuth 2.0-Spezifikation beschrieben.The OAuth 2.0 authorization code flow is described in section 4.1 of the OAuth 2.0 specification.

Weitere Informationen finden Sie unter Authorize access to web applications using OAuth 2.0 and Azure Active Directory (Autorisieren des Zugriffs zu Webanwendungen mithilfe von OAuth 2.0 und Azure Active Directory).For more information, see Authorize access to web applications using OAuth 2.0 and Azure Active Directory.

API-URL-StrukturAPI URL structure

Die Endpunkte der Data Warehouse-API lesen die Entitäten für jeden Satz.The Data Warehouse API endpoints read the entities for each set. Die API unterstützt ein GET HTTP-Verb und eine Teilmenge der Abfrageoptionen.The API supports a GET HTTP verb, and a subset of query options.

Die URL für Intune verwendet das folgende Format:The URL for Intune uses the following format:
https://fef. {Speicherort}.manage.microsoft.com/ReportingService/DataWarehouseFEService/ {Entitätssammlung}? api-Version = {-API-Version}https://fef.{location}.manage.microsoft.com/ReportingService/DataWarehouseFEService/{entity-collection}?api-version={api-version}

Die URL enthält die folgenden Elemente:The URL contains the following elements:

ElementElement BeispielExample BeschreibungDescription
locationlocation msua06msua06 Die Basis-URL kann im Blatt „Data Warehouse API“ im Azure Portal gefunden werden.The base URL can be found by viewing the Data Warehouse API blade in the Azure portal.
Entitätssammlungentity-collection Datendates Der Name der OData-Entitätssammlung.The name of the OData entity collection. Weitere Informationen zu Sammlungen und Entitäten im Datenmodell finden Sie unter Data Model (Datenmodell).For more information on collections and entities in the data model, see Data Model.
api-versionapi-version Betabeta Die Version ist die Version der API, auf die zugegriffen wird.Version is the version of the API to access. Weitere Informationen finden Sie unter Version.For more information, see Version.

Information zur API-VersionAPI version information

Die aktuelle Version der API ist beta.The current version of the API is: beta.

OData-AbfrageoptionenOData query options

Die aktuelle Version unterstützt die folgenden OData-Abfrageparameter: $skip, $top, $filter, $orderby.The current version supports the following OData query parameters: $skip, $top, $filter, $orderby.

Um Feedback zu einem Produkt zu geben, besuchen Sie folgende Seite Intune Feedback