Admin - WorkspaceInfo PostWorkspaceInfo

Reference

Service:: Power BI REST APIs

API Version:: v1.0

Zahájí volání pro příjem metadat pro požadovaný seznam pracovních prostorů.

Důležité

Pokud nastavíte datasetSchema parametry nebo datasetExpressions na truehodnotu , musíte plně povolit prohledávání metadat, aby se data vrátila. Další informace najdete v tématu Povolení nastavení tenanta pro kontrolu metadat.

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ě 500 požadavků za hodinu.
Maximálně 16 souběžných požadavků.

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}

Parametry identifikátoru URI

Name	V	Typ	Description
datasetExpressions	query	boolean	Jestli se mají vracet výrazy datové sady (dotazy DAX a Mashup). Pokud nastavíte tento parametr na `true`hodnotu , musíte plně povolit prohledávání metadat, aby se data vrátila. Další informace najdete v tématu Povolení nastavení tenanta pro kontrolu metadat.
datasetSchema	query	boolean	Jestli se má vrátit schéma datové sady (tabulky, sloupce a míry). Pokud nastavíte tento parametr na `true`hodnotu , musíte plně povolit prohledávání metadat, aby se data vrátila. Další informace najdete v tématu Povolení nastavení tenanta pro kontrolu metadat.
datasourceDetails	query	boolean	Jestli se mají vrátit podrobnosti o zdroji dat
getArtifactUsers	query	boolean	Jestli se mají vrátit podrobnosti o uživateli pro položku Power BI (například sestava nebo řídicí panel)
lineage	query	boolean	Jestli se mají vracet informace o rodokmenu (upstreamové toky dat, dlaždice, ID zdroje dat)

Text požadavku

Name	Typ	Description
workspaces	string[]	Požadovaná ID pracovních prostorů, která se mají zkontrolovat (podporují 1 až 100 ID pracovních prostorů)

Odpovědi

Name	Typ	Description
202 Accepted	ScanRequest	Přijato

Příklady

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

Definice

Name	Description
PowerBIApiErrorResponseDetail	Podrobné informace o chybové odpovědi Power BI
RequiredWorkspaces	Požadavek na požadované pracovní prostory
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

RequiredWorkspaces

Požadavek na požadované pracovní prostory

Name	Typ	Description
workspaces	string[]	Požadovaná ID pracovních prostorů, která se mají zkontrolovat (podporují 1 až 100 ID pracovních prostorů)

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

Sdílet prostřednictvím