Admin - WorkspaceInfo GetScanStatus

Service:

Power BI REST APIs

API Version:

v1.0

Pobiera stan skanowania dla określonego skanowania.

Uprawnienia

Użytkownik musi mieć uprawnienia administratora (takie jak administrator globalny Microsoft 365 lub administrator usługi Power BI) lub uwierzytelnić się przy użyciu jednostki usługi.

W przypadku uruchamiania w ramach uwierzytelniania jednostki usługi aplikacja nie może mieć żadnych uprawnień wymaganych przez administratora dla usługi Power BI ustawionej w Azure Portal.

Zakres wymagany

Tenant.Read.All lub Tenant.ReadWrite.All

Istotne tylko w przypadku uwierzytelniania za pośrednictwem standardowego delegowanego tokenu dostępu administratora. Nie może być obecny, gdy jest używane uwierzytelnianie za pośrednictwem jednostki usługi.

Ograniczenia

Maksymalnie 10 000 żądań na godzinę.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
scanId	path	True	string uuid	Identyfikator skanowania, który jest uwzględniony w odpowiedzi z obszarów roboczych lub Administracja — WorkspaceInfo PostWorkspaceInfo wywołanie interfejsu API, które wyzwoliło skanowanie.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	ScanRequest	OK

Przykłady

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"
}

Definicje

Nazwa	Opis
PowerBIApiErrorResponseDetail	Szczegółowe informacje o odpowiedzi na błędy usługi Power BI
ScanRequest	Żądanie skanowania

PowerBIApiErrorResponseDetail

Szczegółowe informacje o odpowiedzi na błędy usługi Power BI

Nazwa	Typ	Opis
code	string	Kod błędu
message	string	Komunikat o błędzie.
target	string	Element docelowy błędu

ScanRequest

Żądanie skanowania

Nazwa	Typ	Opis
createdDateTime	string	Data i godzina utworzenia skanowania
error	PowerBIApiErrorResponseDetail	Błąd skanowania (jeśli istnieje)
id	string	Identyfikator skanowania
status	string	Stan skanowania