Admin - WorkspaceInfo GetScanStatus

Dienst:: Power BI REST APIs

API-Version:: v1.0

Ruft den Scanstatus für die angegebene Überprüfung ab.

Erlaubnisse

Der Benutzer muss ein Fabric-Administrator sein oder sich mit einem Dienstprinzipal authentifizieren.

Wenn sie unter der Dienstprinzipalauthentifizierung ausgeführt wird, darf eine App keine erforderlichen Administratorberechtigungen für Power BI besitzen, die im Azure-Portal darauf festgelegt sind.

Erforderlicher Bereich

Tenant.Read.All oder Tenant.ReadWrite.All

Relevant nur bei der Authentifizierung über ein standardmäßiges delegiertes Administratorzugriffstoken. 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 Scan-ID, die in der Antwort von den Arbeitsbereichen oder dem Admin - WorkspaceInfo PostWorkspaceInfo-API-Aufruf enthalten ist, der den Scan ausgelöst hat.

Antworten

Name	Typ	Beschreibung
200 OK	ScanRequest	OKAY

Beispiele

Example

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:: 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

Objekt

Detaillierte Informationen zu einer Power BI-Fehlerantwort

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

ScanRequest