Admin - Datasets GetDatasetsAsAdmin

Reference

Service:: Power BI REST APIs

API Version:: v1.0

Vrátí seznam datových sad pro organizaci.

Oprávnění

Uživatel musí mít oprávnění správce (například Office 365 globálního správce nebo správce služby Power BI) nebo ověřování pomocí instančního objektu.
Delegovaná oprávnění jsou podporovaná.

Při spuštění v rámci původního ověřování služby nesmí mít aplikace v Azure Portal nastavená žádná oprávnění vyžadovaná správcem pro Power BI.

Požadovaný obor

Tenant.Read.All nebo Tenant.ReadWrite.All

Relevantní pouze při ověřování prostřednictvím standardního delegovaného přístupového tokenu správce. Nesmí být k dispozici při použití ověřování prostřednictvím instančního objektu.

Omezení

Maximálně 50 požadavků za hodinu nebo 5 požadavků za minutu na tenanta.

GET https://api.powerbi.com/v1.0/myorg/admin/datasets

With optional parameters:

GET https://api.powerbi.com/v1.0/myorg/admin/datasets?$filter={$filter}&$top={$top}&$skip={$skip}

Parametry identifikátoru URI

Name	V	Typ	Description
$filter	query	string	Filtruje výsledky na základě logické podmínky.
$skip	query	integer int32	Přeskočí prvních n výsledků.
$top	query	integer int32	Vrátí pouze prvních n výsledků.

Odpovědi

Name	Typ	Description
200 OK	AdminDatasets	OK

Příklady

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/datasets

Sample Response

Status code:: 200

{
  "value": [
    {
      "id": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
      "name": "SalesMarketing",
      "addRowsAPIEnabled": false,
      "configuredBy": "john@contoso.com",
      "isRefreshable": true,
      "isEffectiveIdentityRequired": false,
      "isEffectiveIdentityRolesRequired": false,
      "isOnPremGatewayRequired": false,
      "isInPlaceSharingEnabled": false,
      "workspaceId": "5c968528-70b6-4588-809f-ce811ffa5c23"
    }
  ]
}

Definice

Name	Description
AdminDataset	Datová sada Power BI vrácená rozhraními SPRÁVA API. Rozhraní API vrátí podmnožinu z následujícího seznamu vlastností datové sady. Podmnožina závisí na volaným rozhraní API, oprávněních volajícího a dostupnosti dat v databázi Power BI.
AdminDatasets	Obálka seznamu datových sad odata
DatasetQueryScaleOutSettings	Dotaz na nastavení škálování datové sady na více instancí
DatasetUser	Položka přístupového práva uživatele Power BI pro datovou sadu
DatasetUserAccessRight	Přístupové právo, které má uživatel k datové sadě (úroveň oprávnění)
DependentDataflow	Tok dat závislý na Power BI
Encryption	Informace o šifrování datové sady
EncryptionStatus	Stav šifrování datové sady
PrincipalType	Typ objektu zabezpečení
ServicePrincipalProfile	Profil objektu zabezpečení služba Power BI. Relevantní pouze pro Power BI Embedded řešení s více tenanty.

AdminDataset

Datová sada Power BI vrácená rozhraními SPRÁVA API. Rozhraní API vrátí podmnožinu z následujícího seznamu vlastností datové sady. Podmnožina závisí na volaným rozhraní API, oprávněních volajícího a dostupnosti dat v databázi Power BI.

Name	Typ	Description
ContentProviderType	string	Typ zprostředkovatele obsahu pro datovou sadu
CreateReportEmbedURL	string	Adresa URL pro vložení sestavy pro vytvoření datové sady
CreatedDate	string	Datum a čas vytvoření datové sady
Encryption	Encryption	Informace o šifrování datové sady. Platí pouze v případě, že `$expand` je zadáno.
IsEffectiveIdentityRequired	boolean	Jestli datová sada vyžaduje efektivní identitu, kterou musíte odeslat ve volání rozhraní API GenerateToken .
IsEffectiveIdentityRolesRequired	boolean	Určuje, jestli je v souboru .pbix Power BI definované zabezpečení na úrovni řádků. Pokud ano, musíte zadat roli.
IsInPlaceSharingEnabled	boolean	Jestli je možné datovou sadu sdílet s externími uživateli, aby ji mohli využívat ve svém vlastním tenantovi.
IsOnPremGatewayRequired	boolean	Jestli datová sada vyžaduje místní bránu dat
IsRefreshable	boolean	Jestli je datová sada aktualizovatelná nebo ne. Aktualizovatelná datová sada Power BI je datová sada, která se alespoň jednou aktualizovala nebo pro kterou existuje platný plán aktualizace.
QnaEmbedURL	string	Adresa URL pro vložení Q&A datové sady
addRowsAPIEnabled	boolean	Jestli datová sada umožňuje přidávat nové řádky
configuredBy	string	Vlastník datové sady
description	string	Popis datové sady
id	string	ID datové sady
name	string	Název datové sady
queryScaleOutSettings	DatasetQueryScaleOutSettings	Dotaz na nastavení škálování datové sady na více instancí
targetStorageMode	string	Režim úložiště datové sady
upstreamDataflows	DependentDataflow[]	Seznam všech toků dat, na které tato položka závisí
users	DatasetUser[]	(Prázdná hodnota) Podrobnosti o přístupu uživatele k datové sadě Tato vlastnost bude odebrána z odpovědi datové části v nadcházející verzi. Informace o uživatelích u položky Power BI (například sestavy nebo řídicího panelu) můžete načíst pomocí rozhraní API Get Dataset Users as Správa nebo rozhraní API PostWorkspaceInfo s parametrem `getArtifactUsers` .
webUrl	string	Webová adresa URL datové sady
workspaceId	string	ID pracovního prostoru datové sady Tato vlastnost bude vrácena pouze v GetDatasetsAsAdmin.

AdminDatasets

Obálka seznamu datových sad odata

Name	Typ	Description
odata.context	string	Kontext OData
value	AdminDataset[]	Datové sady

DatasetQueryScaleOutSettings

Dotaz na nastavení škálování datové sady na více instancí

Name	Typ	Description
autoSyncReadOnlyReplicas	boolean	Jestli datová sada automaticky synchronizuje repliky jen pro čtení
maxReadOnlyReplicas	integer	Maximální počet replik jen pro čtení pro datovou sadu (0–64, -1 pro automatický počet replik)

DatasetUser

Položka přístupového práva uživatele Power BI pro datovou sadu

Name	Typ	Description
datasetUserAccessRight	DatasetUserAccessRight	Přístupové právo, které má uživatel k datové sadě (úroveň oprávnění)
displayName	string	Zobrazovaný název objektu zabezpečení
emailAddress	string	E-mailová adresa uživatele
graphId	string	Identifikátor objektu zabezpečení v Microsoft Graphu. K dispozici pouze pro rozhraní API pro správu.
identifier	string	Identifikátor objektu zabezpečení
principalType	PrincipalType	Typ objektu zabezpečení
profile	ServicePrincipalProfile	Profil objektu zabezpečení služba Power BI. Relevantní pouze pro Power BI Embedded řešení s více tenanty.
userType	string	Typ uživatele.

DatasetUserAccessRight

Přístupové právo, které má uživatel k datové sadě (úroveň oprávnění)

Name	Typ	Description
None	string	Odebere oprávnění k obsahu v datové sadě.
Read	string	Udělí oprávnění ke čtení obsahu v datové sadě.
ReadExplore	string	Udělí přístup ke čtení a prozkoumání obsahu v datové sadě.
ReadReshare	string	Uděluje přístup ke čtení a sdílení obsahu v datové sadě.
ReadReshareExplore	string	Uděluje přístup ke čtení, sdílení a prozkoumání obsahu v datové sadě.
ReadWrite	string	Uděluje přístup ke čtení a zápisu k obsahu v datové sadě.
ReadWriteExplore	string	Uděluje přístup ke čtení, zápisu a prozkoumání obsahu v datové sadě.
ReadWriteReshare	string	Uděluje přístup ke čtení, zápisu a sdílení obsahu v datové sadě.
ReadWriteReshareExplore	string	Uděluje přístup ke čtení, zápisu, sdílení a prozkoumání obsahu v datové sadě.

DependentDataflow

Tok dat závislý na Power BI

Name	Typ	Description
groupId	string	ID cílové skupiny
targetDataflowId	string	ID cílového toku dat

Encryption

Informace o šifrování datové sady

Name	Typ	Description
EncryptionStatus	EncryptionStatus	Stav šifrování datové sady

EncryptionStatus

Stav šifrování datové sady

Name	Typ	Description
InSyncWithWorkspace	string	Šifrování se podporuje a synchronizuje se s nastavením šifrování.
NotInSyncWithWorkspace	string	Šifrování se podporuje, ale není synchronizované s nastavením šifrování.
NotSupported	string	U této datové sady se nepodporuje šifrování.
Unknown	string	Stav šifrování je neznámý kvůli poškození datové sady.

PrincipalType

Typ objektu zabezpečení

Name	Typ	Description
App	string	Typ instančního objektu
Group	string	Typ objektu zabezpečení skupiny
None	string	Žádný typ objektu zabezpečení. Používá se pro přístup na úrovni celé organizace.
User	string	Typ objektu zabezpečení uživatele

ServicePrincipalProfile

Profil objektu zabezpečení služba Power BI. Relevantní pouze pro Power BI Embedded řešení s více tenanty.

Name	Typ	Description
displayName	string	Název profilu instančního objektu
id	string	ID profilu instančního objektu