Admin - Datasets GetDatasetsInGroupAsAdmin
Gibt eine Liste der Datasets aus dem angegebenen Arbeitsbereich zurück.
Berechtigungen
- Der Benutzer muss über Administratorrechte (z. B. Office 365 globalen Administrator oder Power BI-Dienstadministrator) verfügen oder sich mithilfe eines Dienstprinzipals authentifizieren.
- Delegierte Berechtigungen werden unterstützt.
Bei der Ausführung unter dienstprinizipaler 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 200 Anforderungen pro Stunde.
GET https://api.powerbi.com/v1.0/myorg/admin/groups/{groupId}/datasets
GET https://api.powerbi.com/v1.0/myorg/admin/groups/{groupId}/datasets?$filter={$filter}&$top={$top}&$skip={$skip}&$expand={$expand}
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
group
|
path | True |
string uuid |
Arbeitsbereich-ID |
$expand
|
query |
string |
Erweitert verwandte Entitäten inline |
|
$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 |
OK |
Beispiele
Example |
Example with expand on encryption |
Example
Sample Request
GET https://api.powerbi.com/v1.0/myorg/admin/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,
"isInPlaceSharingEnabled": false
}
]
}
Example with expand on encryption
Sample Request
GET https://api.powerbi.com/v1.0/myorg/admin/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets?$expand=encryption
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,
"isInPlaceSharingEnabled": false,
"encryption": {
"id": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
"encryptionStatus": "InSyncWithWorkspace"
}
}
]
}
Definitionen
Name | Beschreibung |
---|---|
Admin |
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 aufgerufenen API, den Aufruferberechtigungen und der Verfügbarkeit der Daten in der Power BI-Datenbank ab. |
Admin |
Odata-Listenwrapper für ein Dataset |
Dataset |
Abfragen von Horizontalskalierungseinstellungen eines Datasets |
Dataset |
Ein Power BI-Benutzerzugriffsrechteintrag für ein Dataset |
Dataset |
Das Zugriffsrecht, das der Benutzer für das Dataset hat (Berechtigungsstufe) |
Dependent |
Ein abhängiger Power BI-Dataflow |
Encryption |
Verschlüsselungsinformationen für ein Dataset |
Encryption |
Datasetverschlüsselung status |
Principal |
Der Prinzipaltyp |
Service |
Ein Power BI-Dienst Prinzipalprofil. Nur relevant für Power BI Embedded Mehrinstanzenlösung. |
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 aufgerufenen API, 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 für die Berichtserstellung für Datasets |
CreatedDate |
string |
Datum und Uhrzeit der Dataseterstellung |
Encryption |
Datasetverschlüsselungsinformationen. Gilt nur, wenn |
|
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, die in ihrem eigenen Mandanten verwendet werden sollen. |
IsOnPremGatewayRequired |
boolean |
Ob das Dataset ein lokales Datengateway erfordert |
IsRefreshable |
boolean |
Gibt an, ob das Dataset aktualisierbar ist 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 |
Die Q&A-Einbettungs-URL des Datasets |
addRowsAPIEnabled |
boolean |
Ob das Dataset das Hinzufügen neuer Zeilen zulässt |
configuredBy |
string |
Der Besitzer des Datasets |
description |
string |
Die Beschreibung des Datasets |
id |
string |
Die Dataset-ID |
name |
string |
Der Name des Datasets |
queryScaleOutSettings |
Abfragen von Horizontalskalierungseinstellungen eines Datasets |
|
targetStorageMode |
string |
Der Datasetspeichermodus |
upstreamDataflows |
Die Liste aller Dataflows, von der dieses Element abhängt |
|
users |
(Leerer Wert) Details zum Benutzerzugriff des Datasets. Diese Eigenschaft wird in einem bevorstehenden Release aus der Nutzlastantwort entfernt. Sie können Benutzerinformationen für ein Power BI-Element (z. B. einen Bericht oder eine Dashboard) abrufen, indem Sie die API zum Abrufen von Datasetbenutzern als Admin oder die PostWorkspaceInfo-API mit dem |
|
webUrl |
string |
Die Web-URL des Datasets |
workspaceId |
string |
Die Arbeitsbereichs-ID des Datasets. Diese Eigenschaft wird nur in GetDatasetsAsAdmin zurückgegeben. |
AdminDatasets
Odata-Listenwrapper für ein Dataset
Name | Typ | Beschreibung |
---|---|---|
odata.context |
string |
OData-Kontext |
value |
Die Datasets |
DatasetQueryScaleOutSettings
Abfragen von Horizontalskalierungseinstellungen eines Datasets
Name | Typ | Beschreibung |
---|---|---|
autoSyncReadOnlyReplicas |
boolean |
Gibt an, ob das Dataset schreibgeschützte Replikate automatisch 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 |
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 |
Der Prinzipaltyp |
|
profile |
Ein Power BI-Dienst Prinzipalprofil. Nur relevant für Power BI Embedded Mehrinstanzenlösung. |
|
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 Erneuten Freigabezugriff auf den Inhalt im Dataset |
ReadReshareExplore |
string |
Gewährt Lese-, Freigabe- und Erkundungszugriff 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 freigabezugriff auf den Inhalt im Dataset |
ReadWriteReshareExplore |
string |
Gewährt Lese-, Schreib-, Freigabe- und Erkundungszugriff auf den Inhalt im Dataset. |
DependentDataflow
Ein abhängiger Power BI-Dataflow
Name | Typ | Beschreibung |
---|---|---|
groupId |
string |
Die Zielgruppen-ID |
targetDataflowId |
string |
Die Ziel-Dataflow-ID |
Encryption
Verschlüsselungsinformationen für ein Dataset
Name | Typ | Beschreibung |
---|---|---|
EncryptionStatus |
Datasetverschlüsselung status |
EncryptionStatus
Datasetverschlüsselung status
Name | Typ | Beschreibung |
---|---|---|
InSyncWithWorkspace |
string |
Die Verschlüsselung wird unterstützt und wird 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 die gesamte organization ebene. |
User |
string |
Benutzerprinzipaltyp |
ServicePrincipalProfile
Ein Power BI-Dienst Prinzipalprofil. Nur relevant für Power BI Embedded Mehrinstanzenlösung.
Name | Typ | Beschreibung |
---|---|---|
displayName |
string |
Der Dienstprinzipalprofilname |
id |
string |
Die Dienstprinzipalprofil-ID |