Admin - Datasets GetDatasetsAsAdmin

Referenz

Service:: Power BI REST APIs

API Version:: v1.0

Gibt eine Liste von Datasets für die organization zurück.

Berechtigungen

Der Benutzer muss über Administratorrechte (z. B. Office 365 globalen Administrator oder Power BI-Dienstadministrator) verfügen oder sich mit einem Dienstprinzipal authentifizieren.
Delegierte Berechtigungen werden unterstützt.

Bei der Ausführung unter dienstprinicipaler Authentifizierung dürfen für eine App keine erforderlichen Administratoreinwilligungsvoreinstellungen für Power BI im Azure-Portal festgelegt sein.

Erforderlicher Bereich

Tenant.Read.All oder Tenant.ReadWrite.All

Nur bei der Authentifizierung über ein standardmäßiges delegiertes Administratorzugriffstoken relevant. Darf nicht vorhanden sein, wenn die Authentifizierung über einen Dienstprinzipal verwendet wird.

Einschränkungen

Maximal 50 Anforderungen pro Stunde oder 5 Anforderungen pro Minute und Mandant.

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}

URI-Parameter

Name	In	Typ	Beschreibung
$filter	query	string	Filtert die Ergebnisse basierend auf einer booleschen Bedingung
$skip	query	integer int32	Überspringt die ersten n-Ergebnisse
$top	query	integer int32	Gibt nur die ersten n-Ergebnisse zurück.

Antworten

Name	Typ	Beschreibung
200 OK	AdminDatasets	OK

Beispiele

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"
    }
  ]
}

Definitionen

Name	Beschreibung
AdminDataset	Ein von Admin APIs zurückgegebenes 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.
AdminDatasets	Ein Dataset-odata-Listen wrapper
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.

AdminDataset

Ein von Admin APIs zurückgegebenes 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
workspaceId	string	Die Dataset-Arbeitsbereichs-ID. Diese Eigenschaft wird nur in GetDatasetsAsAdmin zurückgegeben.

AdminDatasets

Ein Dataset-odata-Listen wrapper

Name	Typ	Beschreibung
odata.context	string	OData-Kontext
value	AdminDataset[]	Die 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