Datasets - Get Datasets

Referenz

Dienst:: Power BI REST APIs

API-Version:: v1.0

Gibt eine Liste von Datasets aus Mein Arbeitsbereichzurück.

Erforderlicher Bereich

Dataset.ReadWrite.All oder Dataset.Read.All

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

Antworten

Name	Typ	Beschreibung
200 OK	Datasets	OKAY

Beispiele

Example

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:: 200

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

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 aufgerufenen API, den Aufruferberechtigungen und der Verfügbarkeit der Daten in der Power BI-Datenbank ab.
DatasetQueryScaleOutSettings	Abfrageskalierungseinstellungen eines Datasets
Datasets	Ein OData-Listenwrapper für Datasets
DatasetUser	Ein Power BI-Benutzerzugriff für ein Dataset
DatasetUserAccessRight	Das Zugriffsrecht, das der Benutzer für das Dataset hat (Berechtigungsstufe)
DependentDataflow	Ein abhängiger Power BI-Datenfluss
Encryption	Verschlüsselungsinformationen für ein Dataset
EncryptionStatus	Datensetverschlüsselungsstatus
PrincipalType	Der Prinzipaltyp
ServicePrincipalProfile	Ein Power BI-Dienstprinzipalprofil. Nur für Power BI Embedded Multi-Mandantenlösungrelevant.

Dataset

Objekt

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

Name	Typ	Beschreibung
ContentProviderType	string	Eine veraltete Eigenschaft, die ignoriert werden soll.
Encryption	Encryption	Datensetverschlü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 innerhalb der Power BI-PBIX-Datei definiert ist. Wenn ja, müssen Sie eine Rolle angeben.
IsInPlaceSharingEnabled	boolean	Gibt an, ob das Dataset für externe Benutzer freigegeben werden kann, die in ihrem eigenen Mandanten genutzt werden sollen.
IsOnPremGatewayRequired	boolean	Gibt an, ob für das Dataset ein lokales Datengateway erforderlich ist.
IsRefreshable	boolean	Dieses Feld gibt `true` zurück, wenn das Dataset kürzlich aktualisiert oder für die automatische Aktualisierung konfiguriert ist, wobei der Verbindungsmodus speziell auf "Import" festgelegt ist. Der Wert gibt `false` für andere Verbindungsmodi zurück, z. B. "DirectQuery" und "LiveConnection", unabhängig davon, ob das Dataset manuell aktualisiert oder für die automatische Aktualisierung eingerichtet wird.
addRowsAPIEnabled	boolean	Gibt an, ob das Dataset das Hinzufügen neuer Zeilen zulässt.
configuredBy	string	Der Datasetbesitzer
createReportEmbedURL	string	Die Datensatz erstellen Berichtseinbettungs-URL
createdDate	string (date-time)	Datum und Uhrzeit der Datensatzerstellung
description	string	Beschreibung des Datasets
id	string	Die Dataset-ID
name	string	Der Datasetname
qnaEmbedURL	string	Das Dataset Q&Eine Einbettungs-URL
queryScaleOutSettings	DatasetQueryScaleOutSettings	Abfrageskalierungseinstellungen eines Datasets
targetStorageMode	string	Der Datasetspeichermodus
upstreamDataflows	DependentDataflow[]	Die Liste aller Datenflüsse dieses Elements hängt von
users	DatasetUser[]	(Leerer Wert) Die Details des Datasetbenutzerzugriffs. Diese Eigenschaft wird aus der Nutzlastantwort in einer bevorstehenden Version 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

Objekt

Abfrageskalierungseinstellungen eines Datasets

Name	Typ	Beschreibung
autoSyncReadOnlyReplicas	boolean	Gibt an, ob das Dataset schreibgeschützte Replikate automatisch synchronisiert.
maxReadOnlyReplicas	integer minimum: -1 maximum: 64	Maximale Anzahl schreibgeschützter Replikate für das Dataset (0-64, -1 für die automatische Anzahl von Replikaten)

Datasets

Objekt

Ein OData-Listenwrapper für Datasets

Name	Typ	Beschreibung
@odata.context	string	OData-Kontext
value	Dataset[]	Die Datasets

DatasetUser

Objekt

Ein Power BI-Benutzerzugriff 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-Dienstprinzipalprofil. Nur für Power BI Embedded Multi-Mandantenlösungrelevant.
userType	string	Typ des Benutzers.

DatasetUserAccessRight

Enumeration

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

Wert	Beschreibung
None	Entfernt die Berechtigung für den Inhalt im Dataset.
Read	Gewährt Lesezugriff auf den Inhalt im Dataset
ReadExplore	Gewährt Lese- und Erkundungszugriff auf den Inhalt im Dataset
ReadReshare	Gewährt Lese- und Freigabezugriff auf den Inhalt im Dataset
ReadReshareExplore	Gewährt Lese-, Freigabe- und Erkunden des Zugriffs auf den Inhalt im Dataset
ReadWrite	Gewährt Lese- und Schreibzugriff auf den Inhalt im Dataset
ReadWriteExplore	Gewährt Lese-, Schreib- und Erkunden des Zugriffs auf den Inhalt im Dataset
ReadWriteReshare	Gewährt Lese-, Schreib- und Freigabezugriff auf den Inhalt im Dataset
ReadWriteReshareExplore	Gewährt Lese-, Schreib-, Refreigabe- und Erkunden des Zugriffs auf den Inhalt im Dataset

DependentDataflow

Objekt

Ein abhängiger Power BI-Datenfluss

Name	Typ	Beschreibung
groupId	string	Die Zielgruppen-ID
targetDataflowId	string	Die Zieldatenfluss-ID

Encryption

Objekt

Verschlüsselungsinformationen für ein Dataset

Name	Typ	Beschreibung
EncryptionStatus	EncryptionStatus	Datensetverschlüsselungsstatus

EncryptionStatus

Enumeration

Datensetverschlüsselungsstatus

Wert	Beschreibung
InSyncWithWorkspace	Die Verschlüsselung wird unterstützt und wird mit den Verschlüsselungseinstellungen synchronisiert.
NotInSyncWithWorkspace	Verschlüsselung wird unterstützt, aber nicht mit den Verschlüsselungseinstellungen synchronisiert
NotSupported	Die Verschlüsselung wird für dieses Dataset nicht unterstützt.
Unknown	Der Verschlüsselungsstatus ist aufgrund von Datasetbeschädigungen unbekannt.

PrincipalType

Enumeration

Der Prinzipaltyp

Wert	Beschreibung
App	Dienstprinzipaltyp
Group	Gruppenprinzipaltyp
None	Kein Prinzipaltyp. Wird für den Zugriff auf ganze Organisationsebene verwendet.
User	Benutzerprinzipaltyp

ServicePrincipalProfile

Objekt

Ein Power BI-Dienstprinzipalprofil. Nur für Power BI Embedded Multi-Mandantenlösungrelevant.

Name	Typ	Beschreibung
displayName	string	Der Dienstprinzipalprofilname
id	string (uuid)	Die Dienstprinzipalprofil-ID

Freigeben über

Datasets - Get Datasets

Erforderlicher Bereich

Antworten

Beispiele

Example

Beispielanforderung

Beispiel für eine Antwort

Definitionen

Dataset

DatasetQueryScaleOutSettings

Datasets

DatasetUser

DatasetUserAccessRight

DependentDataflow

Encryption

EncryptionStatus

PrincipalType

ServicePrincipalProfile