Admin - WorkspaceInfo GetScanStatus

Service:

Power BI REST APIs

API Version:

v1.0

Získá stav kontroly pro zadanou kontrolu.

Oprávnění

Uživatel musí mít oprávnění správce (například globální správce Microsoft 365 nebo správce služby Power BI) nebo ověřování pomocí instančního objektu.

Při spuštění v rámci ověřování instančního objektu nesmí mít aplikace v Azure Portal nastavená oprávnění pro Power BI vyžadovaná souhlasem správce.

Požadovaný obor

Tenant.Read.All nebo Tenant.ReadWrite.All

Relevantní pouze při ověřování prostřednictvím standardního přístupového tokenu delegovaného správce. Nesmí být přítomen, když se používá ověřování prostřednictvím instančního objektu.

Omezení

Maximálně 10 000 požadavků za hodinu.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
scanId	path	True	string uuid	ID kontroly, které je součástí odpovědi z pracovních prostorů nebo volání rozhraní API Správa – WorkspaceInfo PostWorkspaceInfo, které kontrolu aktivovalo.

Odpovědi

Name	Typ	Description
200 OK	ScanRequest	OK

Příklady

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

Definice

Name	Description
PowerBIApiErrorResponseDetail	Podrobné informace o chybové odpovědi Power BI
ScanRequest	Žádost o kontrolu

PowerBIApiErrorResponseDetail

Podrobné informace o chybové odpovědi Power BI

Name	Typ	Description
code	string	Kód chyby
message	string	Chybová zpráva
target	string	Cíl chyby

ScanRequest

Žádost o kontrolu

Name	Typ	Description
createdDateTime	string	Datum a čas vytvoření kontroly
error	PowerBIApiErrorResponseDetail	Chyba kontroly (pokud existuje)
id	string	ID kontroly
status	string	Stav kontroly