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