Sdílet prostřednictvím


Datasets - Get Datasets In Group

Vrátí seznam datových sad ze zadaného pracovního prostoru.

Oprávnění

Toto volání rozhraní API lze volat pomocí profilu instančního objektu. Další informace najdete v tématu Profily instančního objektu v Power BI Embedded.

Požadovaný obor

Dataset.ReadWrite.All nebo Dataset.Read.All

GET https://api.powerbi.com/v1.0/myorg/groups/{groupId}/datasets

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
groupId
path True

string

uuid

ID pracovního prostoru

Odpovědi

Name Typ Description
200 OK

Datasets

OK

Příklady

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets

Sample Response

{
  "value": [
    {
      "id": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
      "name": "SalesMarketing",
      "addRowsAPIEnabled": false,
      "configuredBy": "john@contoso.com",
      "isRefreshable": true,
      "isEffectiveIdentityRequired": false,
      "isEffectiveIdentityRolesRequired": false,
      "isOnPremGatewayRequired": false
    }
  ]
}

Definice

Name Description
Dataset

Datová sada Power BI. 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.

DatasetQueryScaleOutSettings

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

Datasets

Obálka seznamu datových sad OData

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.

Dataset

Datová sada Power BI. 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

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)

Datasets

Obálka seznamu datových sad OData

Name Typ Description
odata.context

string

Kontext OData

value

Dataset[]

Datové sady

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