Sdílet prostřednictvím


Admin - WorkspaceInfo PostWorkspaceInfo

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
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 Vyžadováno Typ Description
datasetExpressions
query

boolean

Jestli se mají vracet výrazy datové sady (dotazy DAX a Mashup). Pokud nastavíte tento parametr 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.

datasetSchema
query

boolean

Jestli se má vrátit schéma datové sady (tabulky, sloupce a míry). Pokud nastavíte tento parametr 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.

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
{
  "workspaces": [
    "97d03602-4873-4760-b37e-1563ef5358e3",
    "67b7e93a-3fb3-493c-9e41-2c5051008f24"
  ]
}

Sample Response

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