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

Condividi tramite