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 eine neue industryDataRun-Datei. Branchendaten automatisieren eine Ausführung alle 12 Stunden; Benutzer können jedoch die Startaktion verwenden, um eine bedarfsgesteuerte Ausführung auszuführen. Der Branchendatendienst drosselt den Start von Ausführungen und ermöglicht bis zu fünf erfolgreiche Ausführungen alle 12 Stunden. Eine bedarfsgesteuerte Ausführung bewirkt, dass die nächste vom System geplante Ausführung übersprungen wird, wenn sie für die Ausführung innerhalb der 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 |
Anwendung | 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 von [longRunningOperation(.. /resources/longrunningoperation.md). Um die status dieses zeitintensiven 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