Admin - Datasets GetDatasetsAsAdmin

Dienst:: Power BI REST APIs

API-Version:: v1.0

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

Erlaubnisse

Der Benutzer muss ein Fabric-Administrator sein oder sich mit einem Dienstprinzipal authentifizieren.
Delegierte Berechtigungen werden unterstützt.

Wenn eine App unter der dienst prinicipalen Authentifizierung ausgeführt wird, darf eine App keine erforderlichen Administratorzustimmungen für Power BI im Azure-Portal festlegen.

Erforderlicher Bereich

Tenant.Read.All oder Tenant.ReadWrite.All

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

Einschränkungen

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

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

Mit optionalen Parametern:

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	Gibt eine Teilmenge einer Ergebnisse basierend auf Odata- Filterabfrageparameterbedingung zurück.
$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	OKAY

Beispiele

Example

Beispielanforderung

GET https://api.powerbi.com/v1.0/myorg/admin/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,
      "isInPlaceSharingEnabled": false,
      "workspaceId": "5c968528-70b6-4588-809f-ce811ffa5c23"
    }
  ]
}

Definitionen

Name	Beschreibung
AdminDataset	Ein Power BI-Dataset, das von Administrator-APIs zurückgegeben wird. 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.
AdminDatasets	Ein Dataset-Odata-Listenwrapper
DatasetQueryScaleOutSettings	Abfrageskalierungseinstellungen eines 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.

AdminDataset

Objekt

Ein Power BI-Dataset, das von Administrator-APIs zurückgegeben wird. 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
workspaceId	string (uuid)	Die Arbeitsbereichs-ID des Datasets. Diese Eigenschaft wird nur in GetDatasetsAsAdmin zurückgegeben.

AdminDatasets

Objekt

Ein Dataset-Odata-Listenwrapper

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

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
ReadWrite	Gewährt Lese- und Schreibzugriff auf den Inhalt im Dataset
ReadReshare	Gewährt Lese- und Freigabezugriff auf den Inhalt im Dataset
ReadWriteReshare	Gewährt Lese-, Schreib- und Freigabezugriff auf den Inhalt im Dataset
ReadExplore	Gewährt Lese- und Erkundungszugriff auf den Inhalt im Dataset
ReadReshareExplore	Gewährt Lese-, Freigabe- und Erkunden des Zugriffs auf den Inhalt im Dataset
ReadWriteExplore	Gewährt Lese-, Schreib- und Erkunden des Zugriffs 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
Unknown	Der Verschlüsselungsstatus ist aufgrund von Datasetbeschädigungen unbekannt.
NotSupported	Die Verschlüsselung wird für dieses Dataset nicht unterstützt.
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

PrincipalType

Enumeration

Der Prinzipaltyp

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

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

Admin - Datasets GetDatasetsAsAdmin

Erlaubnisse

Erforderlicher Bereich

Einschränkungen

URI-Parameter

Antworten

Beispiele

Example

Beispielanforderung

Beispiel für eine Antwort

Definitionen

AdminDataset

AdminDatasets

DatasetQueryScaleOutSettings

DatasetUser

DatasetUserAccessRight

DependentDataflow

Encryption

EncryptionStatus

PrincipalType

ServicePrincipalProfile