Datasets - Get Dataset In Group

Gibt das angegebene Dataset aus dem angegebenen Arbeitsbereich zurück.

Berechtigungen

Dieser API-Aufruf kann von einem Dienstprinzipalprofil aufgerufen werden. Weitere Informationen finden Sie unter Dienstprinzipalprofile in Power BI Embedded.

Erforderlicher Bereich

Dataset.ReadWrite.All oder Dataset.Read.All

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
datasetId
path True

string

Die Dataset-ID

groupId
path True

string

uuid

Arbeitsbereich-ID

Antworten

Name Typ Beschreibung
200 OK

Dataset

OK

Beispiele

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229

Sample Response

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

Definitionen

Name Beschreibung
Dataset

Ein Power BI-Dataset. Die API gibt eine Teilmenge der folgenden Liste der Dataseteigenschaften zurück. Die Teilmenge hängt von der API namens, den Aufruferberechtigungen und der Verfügbarkeit der Daten in der Power BI-Datenbank ab.

DatasetQueryScaleOutSettings

Abfragen von Horizontalskalierungseinstellungen eines Datasets

DatasetUser

Ein Power BI-Benutzerzugriffsrechteintrag für ein Dataset

DatasetUserAccessRight

Das Zugriffsrecht, das der Benutzer für das Dataset hat (Berechtigungsstufe)

DependentDataflow

Ein power BI-abhängiger Dataflow

Encryption

Verschlüsselungsinformationen für ein Dataset

EncryptionStatus

Datasetverschlüsselung status

PrincipalType

Der Prinzipaltyp

ServicePrincipalProfile

Ein Power BI-Dienst Prinzipalprofil. Nur relevant für Power BI Embedded Lösung mit mehreren Mandanten.

Dataset

Ein Power BI-Dataset. Die API gibt eine Teilmenge der folgenden Liste der Dataseteigenschaften zurück. Die Teilmenge hängt von der API namens, den Aufruferberechtigungen und der Verfügbarkeit der Daten in der Power BI-Datenbank ab.

Name Typ Beschreibung
ContentProviderType

string

Der Inhaltsanbietertyp für das Dataset

CreateReportEmbedURL

string

Einbettungs-URL zum Erstellen eines Berichts im Dataset

CreatedDate

string

Datum und Uhrzeit der Dataseterstellung

Encryption

Encryption

Datasetverschlüsselungsinformationen. Gilt nur, wenn $expand angegeben wird.

IsEffectiveIdentityRequired

boolean

Gibt an, ob das Dataset eine effektive Identität erfordert, die Sie in einem GenerateToken-API-Aufruf senden müssen.

IsEffectiveIdentityRolesRequired

boolean

Gibt an, ob die Sicherheit auf Zeilenebene in der Pbix-Datei von Power BI definiert ist. Wenn ja, müssen Sie eine Rolle angeben.

IsInPlaceSharingEnabled

boolean

Gibt an, ob das Dataset für externe Benutzer freigegeben werden kann, um es in ihrem eigenen Mandanten zu verwenden

IsOnPremGatewayRequired

boolean

Ob das Dataset ein lokales Datengateway erfordert

IsRefreshable

boolean

Gibt an, ob das Dataset aktualisiert werden kann oder nicht. Ein aktualisierbares Power BI-Dataset ist ein Dataset, das mindestens einmal aktualisiert wurde oder für das ein gültiger Aktualisierungszeitplan vorhanden ist.

QnaEmbedURL

string

Das Dataset Q&A Einbettungs-URL

addRowsAPIEnabled

boolean

Ob das Dataset das Hinzufügen neuer Zeilen zulässt

configuredBy

string

Der Datasetbesitzer

description

string

Beschreibung des Datasets

id

string

Die Dataset-ID

name

string

Der Datasetname

queryScaleOutSettings

DatasetQueryScaleOutSettings

Abfragen von Horizontalskalierungseinstellungen eines Datasets

targetStorageMode

string

Der Datasetspeichermodus

upstreamDataflows

DependentDataflow[]

Die Liste aller Dataflows, von der dieses Element abhängt

users

DatasetUser[]

(Leerer Wert) Die Details des Datasetbenutzerzugriffs. Diese Eigenschaft wird in einer bevorstehenden Version aus der Nutzlastantwort entfernt. Sie können Benutzerinformationen zu einem Power BI-Element (z. B. einem Bericht oder einem Dashboard) abrufen, indem Sie die Get Dataset Users as Admin API oder die PostWorkspaceInfo-API mit dem getArtifactUsers Parameter verwenden.

webUrl

string

Die Web-URL des Datasets

DatasetQueryScaleOutSettings

Abfragen von Horizontalskalierungseinstellungen eines Datasets

Name Typ Beschreibung
autoSyncReadOnlyReplicas

boolean

Gibt an, ob das Dataset automatisch schreibgeschützte Replikate synchronisiert

maxReadOnlyReplicas

integer

Maximale Anzahl schreibgeschützter Replikate für das Dataset (0-64, -1 für die automatische Anzahl von Replikaten)

DatasetUser

Ein Power BI-Benutzerzugriffsrechteintrag für ein Dataset

Name Typ Beschreibung
datasetUserAccessRight

DatasetUserAccessRight

Das Zugriffsrecht, das der Benutzer für das Dataset hat (Berechtigungsstufe)

displayName

string

Anzeigename des Prinzipals

emailAddress

string

E-Mail-Adresse des Benutzers

graphId

string

Bezeichner des Prinzipals in Microsoft Graph. Nur für Administrator-APIs verfügbar.

identifier

string

Bezeichner des Prinzipals

principalType

PrincipalType

Der Prinzipaltyp

profile

ServicePrincipalProfile

Ein Power BI-Dienst Prinzipalprofil. Nur relevant für Power BI Embedded Lösung mit mehreren Mandanten.

userType

string

Typ des Benutzers.

DatasetUserAccessRight

Das Zugriffsrecht, das der Benutzer für das Dataset hat (Berechtigungsstufe)

Name Typ Beschreibung
None

string

Entfernt die Berechtigung für den Inhalt im Dataset.

Read

string

Gewährt Lesezugriff auf den Inhalt im Dataset

ReadExplore

string

Gewährt Lese- und Erkundungszugriff auf den Inhalt im Dataset

ReadReshare

string

Gewährt Lese- und Freigabezugriff auf den Inhalt im Dataset

ReadReshareExplore

string

Gewährt Lese-, Freigabe- und Erkundenzugriff auf den Inhalt im Dataset

ReadWrite

string

Gewährt Lese- und Schreibzugriff auf den Inhalt im Dataset

ReadWriteExplore

string

Gewährt Lese-, Schreib- und Erkundungszugriff auf den Inhalt im Dataset

ReadWriteReshare

string

Gewährt Lese-, Schreib- und Wiederfreigabezugriff auf den Inhalt im Dataset

ReadWriteReshareExplore

string

Gewährt Lese-, Schreib-, Weiterfreigabe- und Erkundenzugriff auf den Inhalt im Dataset

DependentDataflow

Ein power BI-abhängiger Dataflow

Name Typ Beschreibung
groupId

string

Die Zielgruppen-ID

targetDataflowId

string

Die Zieldatenfluss-ID

Encryption

Verschlüsselungsinformationen für ein Dataset

Name Typ Beschreibung
EncryptionStatus

EncryptionStatus

Datasetverschlüsselung status

EncryptionStatus

Datasetverschlüsselung status

Name Typ Beschreibung
InSyncWithWorkspace

string

Die Verschlüsselung wird unterstützt und ist mit den Verschlüsselungseinstellungen synchronisiert.

NotInSyncWithWorkspace

string

Die Verschlüsselung wird unterstützt, ist aber nicht mit den Verschlüsselungseinstellungen synchronisiert.

NotSupported

string

Die Verschlüsselung wird für dieses Dataset nicht unterstützt.

Unknown

string

Die Verschlüsselung status ist aufgrund einer Datasetbeschädigung unbekannt.

PrincipalType

Der Prinzipaltyp

Name Typ Beschreibung
App

string

Dienstprinzipaltyp

Group

string

Gruppenprinzipaltyp

None

string

Kein Prinzipaltyp. Verwenden Sie für den Zugriff auf organization ganzen Organization ebene.

User

string

Benutzerprinzipaltyp

ServicePrincipalProfile

Ein Power BI-Dienst Prinzipalprofil. Nur relevant für Power BI Embedded Lösung mit mehreren Mandanten.

Name Typ Beschreibung
displayName

string

Der Dienstprinzipalprofilname

id

string

Die Dienstprinzipalprofil-ID