industryDataRun: start

Namespace: microsoft.graph.industryData

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Starten Sie einen neuen industryDataRun. Branchendaten automatisieren alle 12 Stunden eine Ausführung; Benutzer können jedoch die Aktion "Starten" verwenden, um eine bedarfsgesteuerte Ausführung durchzuführen. Der Branchendatendienst drosselt den Start von Läufen und ermöglicht so bis zu fünf erfolgreiche Läufe alle 12 Stunden. Eine bedarfsgesteuerte Ausführung bewirkt, dass die nächste vom System geplante Ausführung übersprungen wird, wenn sie für die nächsten 10 Stunden festgelegt ist.

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Weltweiter Service US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet

Berechtigungen

Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Berechtigungstyp Berechtigungen mit den geringsten Berechtigungen Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto) IndustryData-Run.Start Nicht verfügbar.
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Application IndustryData-Run.Start Nicht verfügbar.

HTTP-Anforderung

POST /external/industryData/runs/start

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung.

Anforderungstext

Geben Sie keinen Anforderungstext für diese Methode an.

Antwort

Wenn die Methode erfolgreich verläuft, wird der Antwortcode 202 Accepted zurückgegeben. Die Antwort enthält auch einen Location Header, der den Speicherort der [longRunningOperation(.. /resources/longrunningoperation.md). Um den Status dieses langwierigen Vorgangs zu überprüfen, senden Sie eine GET-Anforderung an die Standort-URL.

Beispiele

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

POST https://graph.microsoft.com/beta/external/industryData/runs/start

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 202 Accepted
Location: https://graph.microsoft.com/beta/external/industryData/operations/171bf0b4-14e9-408f-71dd-08dcd2a15d23