Admin - WorkspaceInfo GetScanStatus

Service:

Power BI REST APIs

API Version:

v1.0

Ruft den Scanstatus für den angegebenen Scan ab.

Berechtigungen

Der Benutzer muss über Administratorrechte (z. B. Microsoft globalen Administrator 365 oder Power BI-Dienstadministrator) verfügen oder sich mithilfe eines Dienstprinzipals authentifizieren.

Bei der Ausführung unter Der Dienstprinzipalauthentifizierung darf eine App keine erforderlichen Berechtigungen für Die Administratoreinwilligung für Power BI im Azure-Portal festgelegt haben.

Erforderlicher Bereich

Tenant.Read.All oder Tenant.ReadWrite.All

Nur bei der Authentifizierung über ein standardmäßiges delegiertes Administratorzugriffstoken relevant. Darf nicht vorhanden sein, wenn die Authentifizierung über einen Dienstprinzipal verwendet wird.

Einschränkungen

Maximal 10.000 Anforderungen pro Stunde.

GET https://api.powerbi.com/v1.0/myorg/admin/workspaces/scanStatus/{scanId}

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
scanId	path	True	string uuid	Die Überprüfungs-ID, die in der Antwort der Arbeitsbereiche oder des api-Aufrufs Admin – WorkspaceInfo PostWorkspaceInfo enthalten ist, der den Scan ausgelöst hat.

Antworten

Name	Typ	Beschreibung
200 OK	ScanRequest	OK

Beispiele

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/workspaces/scanStatus/e7d03602-4873-4760-b37e-1563ef5358e3

Sample Response

Status code:

200

{
  "id": "e7d03602-4873-4760-b37e-1563ef5358e3",
  "createdDateTime": "2020-06-15T16:46:28.0487687Z",
  "status": "Succeeded"
}

Definitionen

Name	Beschreibung
PowerBIApiErrorResponseDetail	Detaillierte Informationen zu einer Power BI-Fehlerantwort
ScanRequest	Eine Scananforderung

PowerBIApiErrorResponseDetail

Detaillierte Informationen zu einer Power BI-Fehlerantwort

Name	Typ	Beschreibung
code	string	Den Fehlercode
message	string	Die Fehlermeldung
target	string	Das Fehlerziel

ScanRequest

Eine Scananforderung

Name	Typ	Beschreibung
createdDateTime	string	Datum und Uhrzeit der Überprüfungserstellung
error	PowerBIApiErrorResponseDetail	Der Überprüfungsfehler (falls vorhanden)
id	string	Die Scan-ID
status	string	Der Scanstatus