Share via


Admin - WorkspaceInfo GetScanStatus

Ottiene lo stato di analisi per l'analisi specificata.

Autorizzazioni

L'utente deve disporre dei diritti di amministratore, ad esempio Microsoft 365 Amministratore globale o amministratore del servizio Power BI, oppure eseguire l'autenticazione usando un'entità servizio.

Quando viene eseguita nell'autenticazione dell'entità servizio, un'app non deve disporre di autorizzazioni necessarie per il consenso amministratore per Power BI impostata nel portale di Azure.

Ambito obbligatorio

Tenant.Read.All o Tenant.ReadWrite.All

Pertinente solo quando si esegue l'autenticazione tramite un token di accesso amministratore delegato standard. Non deve essere presente quando viene usata l'autenticazione tramite un'entità servizio.

Limitazioni

Massimo 10.000 richieste all'ora.

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
scanId
path True

string

uuid

ID analisi, incluso nella risposta dalle aree di lavoro o dall'API Amministrazione - WorkspaceInfo PostWorkspaceInfo che ha attivato l'analisi.

Risposte

Nome Tipo Descrizione
200 OK

ScanRequest

OK

Esempio

Example

Sample Request

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

Sample Response

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

Definizioni

Nome Descrizione
PowerBIApiErrorResponseDetail

Informazioni dettagliate su una risposta di errore di Power BI

ScanRequest

Richiesta di analisi

PowerBIApiErrorResponseDetail

Informazioni dettagliate su una risposta di errore di Power BI

Nome Tipo Descrizione
code

string

Il codice di errore

message

string

Messaggio di errore.

target

string

Destinazione dell'errore

ScanRequest

Richiesta di analisi

Nome Tipo Descrizione
createdDateTime

string

Data e ora di creazione dell'analisi

error

PowerBIApiErrorResponseDetail

Errore di analisi (se presente)

id

string

ID analisi

status

string

Stato di analisi