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 |
---|---|---|---|---|
group
|
path | True |
string uuid |
ID pracovního prostoru |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
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. |
Dataset |
Dotaz na nastavení škálování datové sady na více instancí |
Datasets |
Obálka seznamu datových sad OData |
Dataset |
Položka přístupového práva uživatele Power BI pro datovou sadu |
Dataset |
Přístupové právo, které má uživatel k datové sadě (úroveň oprávnění) |
Dependent |
Tok dat závislý na Power BI |
Encryption |
Informace o šifrování datové sady |
Encryption |
Stav šifrování datové sady |
Principal |
Typ objektu zabezpečení |
Service |
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 |
Informace o šifrování datové sady. Platí pouze v případě, že |
|
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 |
Dotaz na nastavení škálování datové sady na více instancí |
|
targetStorageMode |
string |
Režim úložiště datové sady |
upstreamDataflows |
Seznam všech toků dat, na které tato položka závisí |
|
users |
(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 |
|
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 |
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 |
Typ objektu zabezpečení |
|
profile |
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 |
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 |