Admin - WorkspaceInfo PostWorkspaceInfo

  • Riferimento
Service:
Power BI REST APIs
API Version:
v1.0

Avvia una chiamata per ricevere metadati per l'elenco richiesto di aree di lavoro.

Importante

Se si impostano i parametri o datasetExpressions su true, è necessario abilitare completamente l'analisi datasetSchema dei metadati per restituire i dati. Per altre informazioni, vedere Abilitare le impostazioni del tenant per l'analisi dei metadati.

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 500 richieste all'ora.
  • Massimo 16 richieste simultanee. 

POST https://api.powerbi.com/v1.0/myorg/admin/workspaces/getInfo
With optional parameters: 
POST https://api.powerbi.com/v1.0/myorg/admin/workspaces/getInfo?lineage={lineage}&datasourceDetails={datasourceDetails}&datasetSchema={datasetSchema}&datasetExpressions={datasetExpressions}&getArtifactUsers={getArtifactUsers}

Parametri dell'URI

Nome In Necessario Tipo Descrizione
datasetExpressions
 query

boolean

Indica se restituire le espressioni del set di dati (query DAX e Mashup). Se si imposta questo parametro su true, è necessario abilitare completamente l'analisi dei metadati per restituire i dati. Per altre informazioni, vedere Abilitare le impostazioni del tenant per l'analisi dei metadati.
datasetSchema
 query

boolean

Se restituire lo schema del set di dati (tabelle, colonne e misure). Se si imposta questo parametro su true, è necessario abilitare completamente l'analisi dei metadati per restituire i dati. Per altre informazioni, vedere Abilitare le impostazioni del tenant per l'analisi dei metadati.
datasourceDetails
 query

boolean

Indica se restituire i dettagli dell'origine dati
getArtifactUsers
 query

boolean

Indica se restituire i dettagli dell'utente per un elemento di Power BI (ad esempio un report o un dashboard)
lineage
 query

boolean

Indica se restituire informazioni di derivazione (flussi di dati upstream, riquadri, ID origine dati)

Corpo della richiesta

Nome Tipo Descrizione
workspaces

string[]

ID dell'area di lavoro necessari da analizzare (supporta 1 a 100 ID area di lavoro)

Risposte

Nome Tipo Descrizione
202 Accepted

ScanRequest

Accettato

Esempio

Example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/admin/workspaces/getInfo?lineage=True&datasourceDetails=True&datasetSchema=True&datasetExpressions=True
Request Body
{
  "workspaces": [
    "97d03602-4873-4760-b37e-1563ef5358e3",
    "67b7e93a-3fb3-493c-9e41-2c5051008f24"
  ]
}

Sample Response

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

Definizioni

Nome Descrizione
PowerBIApiErrorResponseDetail

Informazioni dettagliate su una risposta di errore di Power BI
RequiredWorkspaces

Richiesta di aree di lavoro necessarie
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

RequiredWorkspaces

Richiesta di aree di lavoro necessarie

Nome Tipo Descrizione
workspaces

string[]

ID dell'area di lavoro necessari da analizzare (supporta 1 a 100 ID area di lavoro)

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