Admin - Groups UpdateGroupAsAdmin

Referenz

Service:: Power BI REST APIs

API Version:: v1.0

Updates die Eigenschaften des angegebenen Arbeitsbereichs.

Um die Zuweisung eines Log Analytics-Arbeitsbereichs aufzuheben, legen Sie den Wert explizit auf NULL fest.

Berechtigungen

Der Benutzer muss über Administratorrechte verfügen (z. B. Office 365 globaler Administrator oder Power BI-Dienstadministrator).

Erforderlicher Bereich

Tenant.ReadWrite.All

Einschränkungen

Maximal 200 Anforderungen pro Stunde.
Für freigegebene Kapazitäten können nur der Name und die Beschreibung aktualisiert werden.
Für Premium-Kapazitäten können nur name, beschreibung, defaultDatasetStorageFormat und Log Analytics-Arbeitsbereich aktualisiert werden.
Der Name muss innerhalb eines organization eindeutig sein.

PATCH https://api.powerbi.com/v1.0/myorg/admin/groups/{groupId}

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
groupId	path	True	string uuid	Arbeitsbereich-ID

Anforderungstext

Name	Erforderlich	Typ	Beschreibung
id	True	string	Arbeitsbereich-ID
capacityId		string	Die Kapazitäts-ID
dashboards		AdminDashboard[]	Die Dashboards, die zur Gruppe gehören
dataflowStorageId		string	Die Speicherkonto-ID des Power BI-Dataflows
dataflows		AdminDataflow[]	Die Dataflows, die zur Gruppe gehören
datasets		AdminDataset[]	Die Datasets, die zur Gruppe gehören
defaultDatasetStorageFormat		DefaultDatasetStorageFormat	Das Standardmäßige Datasetspeicherformat im Arbeitsbereich. Wird nur zurückgegeben, wenn `isOnDedicatedCapacitytrue`
description		string	Die Gruppenbeschreibung
hasWorkspaceLevelSettings		boolean	Ob der Arbeitsbereich über benutzerdefinierte Einstellungen verfügt
isOnDedicatedCapacity		boolean	Ob die Gruppe einer dedizierten Kapazität zugewiesen ist
isReadOnly		boolean	Ob die Gruppe schreibgeschützt ist
logAnalyticsWorkspace		AzureResource	Der der Gruppe zugewiesene Log Analytics-Arbeitsbereich. Dies wird nur zurückgegeben, wenn eine einzelne Gruppe abgerufen wird.
name		string	Der Gruppenname
pipelineId		string	Die Id der Bereitstellungspipeline, der der Arbeitsbereich zugewiesen ist.
reports		AdminReport[]	Die Berichte, die zur Gruppe gehören
state		string	Der Gruppenstatus
type		GroupType	Der Typ der zurückgegebenen Gruppe.
users		GroupUser[]	(Leerer Wert) Die Benutzer, die der Gruppe angehören, und deren Zugriffsrechte. 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 den API-Aufruf Get Group Users As Admin oder den PostWorkspaceInfo-API-Aufruf mit dem `getArtifactUsers` Parameter verwenden.
workbooks		Workbook[]	Die Arbeitsmappen, die zur Gruppe gehören

Antworten

Name	Typ	Beschreibung
200 OK		OK

Beispiele

Example of assigning Log Analytics workspace

Example of unassigning Log Analytics workspace

Example of updating group description and defaultDatasetStorageFormat

Example of assigning Log Analytics workspace

Sample Request

PATCH https://api.powerbi.com/v1.0/myorg/admin/groups/e2284830-c8dc-416b-b19a-8cdcd2729332

Request Body

{
  "logAnalyticsWorkspace": {
    "subscriptionId": "d778934f-bda2-41d9-b5c7-6cf41372c1a0",
    "resourceGroup": "myResourceGroup",
    "resourceName": "myLogAnalyticsWorkspace"
  }
}

Sample Response

Status code:: 200

Example of unassigning Log Analytics workspace

Sample Request

PATCH https://api.powerbi.com/v1.0/myorg/admin/groups/e2284830-c8dc-416b-b19a-8cdcd2729332

Request Body

{
  "logAnalyticsWorkspace": null
}

Sample Response

Status code:: 200

Example of updating group description and defaultDatasetStorageFormat

Sample Request

PATCH https://api.powerbi.com/v1.0/myorg/admin/groups/e2284830-c8dc-416b-b19a-8cdcd2729332

Request Body

{
  "name": "Updated Sales Results",
  "description": "Refreshed sales numbers",
  "defaultDatasetStorageFormat": "Large"
}

Sample Response

Status code:: 200

Definitionen

Name	Beschreibung
AdminDashboard	Eine Power BI-Dashboard, die von Admin-APIs zurückgegeben wird. Die API gibt eine Teilmenge der folgenden Liste von Dashboard Eigenschaften zurück. Die Teilmenge hängt von der aufgerufenen API, den Aufruferberechtigungen und der Verfügbarkeit von Daten in der Power BI-Datenbank ab.
AdminDataflow	Die Metadaten eines Dataflows, der von Admin-APIs zurückgegeben wird. Im Folgenden finden Sie eine Liste der Eigenschaften, die für einen Dataflow zurückgegeben werden können. Abhängig von der aufgerufenen API, den Aufrufberechtigungen und der Verfügbarkeit der Daten in der Power BI-Datenbank wird nur eine Teilmenge der Eigenschaften zurückgegeben.
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.
AdminGroup	Eine von Administrator-APIs zurückgegebene Power BI-Gruppe
AdminReport	Ein von Admin APIs zurückgegebener Power BI-Bericht. Die API gibt eine Teilmenge der folgenden Liste der Berichtseigenschaften zurück. Die Teilmenge hängt von der aufgerufenen API, den Aufruferberechtigungen und der Verfügbarkeit von Daten in der Power BI-Datenbank ab.
AdminTile	Eine Power BI-Kachel, die von Admin-APIs zurückgegeben wird.
AzureResource	Eine Antwort, die eine benutzereigene Azure-Ressource enthält, z. B. einen Log Analytics-Arbeitsbereich.
DashboardUser	Ein Power BI-Benutzerzugriffsrechteintrag für eine Dashboard
DashboardUserAccessRight	Das Zugriffsrecht, das der Benutzer für die Dashboard hat (Berechtigungsstufe)
DataflowUser	Ein Power BI-Benutzerzugriffsrechteintrag für einen Dataflow
DataflowUserAccessRight	Das Zugriffsrecht, das ein Benutzer für den Dataflow hat (Berechtigungsstufe)
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)
DefaultDatasetStorageFormat	Das Standardspeicherformat für Datasets in der Gruppe
DependentDataflow	Ein abhängiger Power BI-Dataflow
Encryption	Verschlüsselungsinformationen für ein Dataset
EncryptionStatus	Datasetverschlüsselung status
GroupType	Der Gruppentyp
GroupUser	Ein Power BI-Benutzer mit Zugriff auf den Arbeitsbereich
GroupUserAccessRight	Das Zugriffsrecht (Berechtigungsstufe), das ein Benutzer im Arbeitsbereich hat
PrincipalType	Der Prinzipaltyp
ReportUser	Ein Power BI-Benutzerzugriffsrechteintrag für einen Bericht
ReportUserAccessRight	Das Zugriffsrecht, das der Benutzer für den Bericht hat (Berechtigungsstufe)
ServicePrincipalProfile	Ein Power BI-Dienst Prinzipalprofil. Nur relevant für Power BI Embedded Lösung mit mehreren Mandanten.
Subscription	Ein E-Mail-Abonnement für ein Power BI-Element (z. B. einen Bericht oder eine Dashboard)
SubscriptionUser	Ein Power BI-E-Mail-Abonnementbenutzer
Workbook	Eine Power BI-Arbeitsmappe

AdminDashboard

Eine Power BI-Dashboard, die von Admin-APIs zurückgegeben wird. Die API gibt eine Teilmenge der folgenden Liste von Dashboard Eigenschaften zurück. Die Teilmenge hängt von der aufgerufenen API, den Aufruferberechtigungen und der Verfügbarkeit von Daten in der Power BI-Datenbank ab.

Name	Typ	Beschreibung
appId	string	Die App-ID, die nur zurückgegeben wird, wenn die Dashboard zu einer App gehört.
displayName	string	Der Anzeigename des Dashboard
embedUrl	string	Die Einbettungs-URL der Dashboard
id	string	Die Dashboard-ID
isReadOnly	boolean	Gibt an, ob die Dashboard schreibgeschützt ist.
subscriptions	Subscription[]	(Leerer Wert) Die Abonnementdetails für ein Power BI-Element (z. B. einen Bericht oder eine Dashboard). Diese Eigenschaft wird in einem bevorstehenden Release aus der Nutzlastantwort entfernt. Sie können Abonnementinformationen für einen Power BI-Bericht abrufen, indem Sie den API-Aufruf Zum Abrufen von Berichtsabonnements als Admin verwenden.
tiles	AdminTile[]	Die Kacheln, die zum Dashboard gehören
users	DashboardUser[]	(Leerer Wert) Die Dashboard Benutzerzugriffsdetails. Diese Eigenschaft wird in einem bevorstehenden Release aus der Nutzlastantwort entfernt. Sie können Benutzerinformationen zu einem Power BI-Dashboard abrufen, indem Sie den Aufruf Dashboardbenutzer als Admin API abrufen oder den Api-Aufruf PostWorkspaceInfo mit dem `getArtifactUsers` Parameter verwenden.
webUrl	string	Die Web-URL der Dashboard
workspaceId	string	Die Arbeitsbereichs-ID (GUID) des Dashboard. Diese Eigenschaft wird nur in GetDashboardsAsAdmin zurückgegeben.

AdminDataflow

Die Metadaten eines Dataflows, der von Admin-APIs zurückgegeben wird. Im Folgenden finden Sie eine Liste der Eigenschaften, die für einen Dataflow zurückgegeben werden können. Abhängig von der aufgerufenen API, den Aufrufberechtigungen und der Verfügbarkeit der Daten in der Power BI-Datenbank wird nur eine Teilmenge der Eigenschaften zurückgegeben.

Name	Typ	Beschreibung
configuredBy	string	Der Dataflowbesitzer
description	string	Die Beschreibung des Dataflows
modelUrl	string	Eine URL zur Dataflowdefinitionsdatei (model.json)
modifiedBy	string	Der Benutzer, der den Dataflow geändert hat
modifiedDateTime	string	Datum und Uhrzeit der letzten Änderung des Dataflows
name	string	Der Name des Dataflows
objectId	string	Die Dataflow-ID
users	DataflowUser[]	(Leerer Wert) Die Datenflussbenutzerzugriffsdetails. Diese Eigenschaft wird in einer bevorstehenden Version aus der Nutzlastantwort entfernt. Sie können Benutzerinformationen zu einem Power BI-Dataflow abrufen, indem Sie dataflow-Benutzer als Admin API-Aufruf oder den PostWorkspaceInfo-API-Aufruf mit dem `getArtifactUser` Parameter verwenden.
workspaceId	string	Die Dataflow-Arbeitsbereichs-ID.

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	Encryption	Datasetverschlüsselungsinformationen. Gilt nur, wenn `$expand` angegeben ist.
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	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) 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 `getArtifactUsers` Parameter verwenden.
webUrl	string	Die Web-URL des Datasets
workspaceId	string	Die Arbeitsbereichs-ID des Datasets. Diese Eigenschaft wird nur in GetDatasetsAsAdmin zurückgegeben.

AdminGroup

Eine von Administrator-APIs zurückgegebene Power BI-Gruppe

Name	Typ	Beschreibung
capacityId	string	Die Kapazitäts-ID
dashboards	AdminDashboard[]	Die Dashboards, die zur Gruppe gehören
dataflowStorageId	string	Die Id des Power BI-Dataflow-Speicherkontos
dataflows	AdminDataflow[]	Die Dataflows, die zur Gruppe gehören
datasets	AdminDataset[]	Die Datasets, die zur Gruppe gehören
defaultDatasetStorageFormat	DefaultDatasetStorageFormat	Das Standarddatasetspeicherformat im Arbeitsbereich. Nur zurückgegeben, wenn `isOnDedicatedCapacitytrue`
description	string	Die Gruppenbeschreibung
hasWorkspaceLevelSettings	boolean	Gibt an, ob der Arbeitsbereich über benutzerdefinierte Einstellungen verfügt
id	string	Arbeitsbereich-ID
isOnDedicatedCapacity	boolean	Gibt an, ob die Gruppe einer dedizierten Kapazität zugewiesen ist
isReadOnly	boolean	Gibt an, ob die Gruppe schreibgeschützt ist
logAnalyticsWorkspace	AzureResource	Der Log Analytics-Arbeitsbereich, der der Gruppe zugewiesen ist. Dies wird nur zurückgegeben, wenn eine einzelne Gruppe abgerufen wird.
name	string	Der Gruppenname
pipelineId	string	Die Bereitstellungspipeline-ID, der der Arbeitsbereich zugewiesen ist.
reports	AdminReport[]	Die Berichte, die zur Gruppe gehören
state	string	Der Gruppenstatus
type	GroupType	Der Typ der zurückgegebenen Gruppe.
users	GroupUser[]	(Leerer Wert) Die Benutzer, die zur Gruppe gehören, und ihre Zugriffsrechte. 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 den API-Aufruf "Gruppenbenutzer als Admin abrufen" oder den PostWorkspaceInfo-API-Aufruf mit dem `getArtifactUsers` Parameter verwenden.
workbooks	Workbook[]	Die Arbeitsmappen, die zur Gruppe gehören

AdminReport

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

Name	Typ	Beschreibung
appId	string	Die App-ID, die nur zurückgegeben wird, wenn der Bericht zu einer App gehört
createdBy	string	Der Besitzer des Berichts. Nur für Berichte verfügbar, die nach Juni 2019 erstellt wurden.
createdDateTime	string	Datum und Uhrzeit der Berichtserstellung
datasetId	string	Die Dataset-ID des Berichts
description	string	Die Berichtsbeschreibung
embedUrl	string	Die Einbettungs-URL des Berichts
id	string	Die Berichts-ID
isOwnedByMe	boolean	Ermitteln Sie, ob der Bericht vom aktuellen Benutzer erstellt wird.
modifiedBy	string	Der letzte Benutzer, der den Bericht geändert hat
modifiedDateTime	string	Datum und Uhrzeit der letzten Änderung des Berichts
name	string	Der Name des Berichts
originalReportId	string	Die tatsächliche Berichts-ID, wenn der Arbeitsbereich als App veröffentlicht wird.
reportType	enum: PaginatedReport PowerBIReport	Der Berichtstyp
subscriptions	Subscription[]	(Leerer Wert) Die Abonnementdetails für ein Power BI-Element (z. B. einen Bericht oder eine Dashboard). Diese Eigenschaft wird in einem bevorstehenden Release aus der Nutzlastantwort entfernt. Sie können Abonnementinformationen für einen Power BI-Bericht abrufen, indem Sie den API-Aufruf Zum Abrufen von Berichtsabonnements als Admin verwenden.
users	ReportUser[]	(Leerer Wert) Die Benutzerzugriffsdetails für einen Power BI-Bericht. Diese Eigenschaft wird in einem bevorstehenden Release aus der Nutzlastantwort entfernt. Sie können Benutzerinformationen für einen Power BI-Bericht abrufen, indem Sie den Aufruf "Berichtsbenutzer als Admin API abrufen" oder den API-Aufruf PostWorkspaceInfo mit dem `getArtifactUsers` -Parameter verwenden.
webUrl	string	Die Web-URL des Berichts
workspaceId	string	Die Arbeitsbereichs-ID (GUID) des Berichts. Diese Eigenschaft wird nur in GetReportsAsAdmin zurückgegeben.

AdminTile

Eine Power BI-Kachel, die von Admin-APIs zurückgegeben wird.

Name	Typ	Beschreibung
colSpan	integer	Die Anzahl der Kachelspannenspalten
datasetId	string	Die Dataset-ID. Verfügbar nur für Kacheln, die aus einem Bericht oder mithilfe eines Datasets erstellt wurden, z. B. Q&A-Kacheln.
embedData	string	Die Einbettungsdaten für die Kachel
embedUrl	string	Die Einbettungs-URL der Kachel
id	string	Die Kachel-ID
reportId	string	Die Berichts-ID. Nur für Kacheln verfügbar, die aus einem Bericht erstellt wurden.
rowSpan	integer	Die Anzahl der Kachelspannzeilen
title	string	Der Anzeigename der Kachel

AzureResource

Eine Antwort, die eine benutzereigene Azure-Ressource enthält, z. B. einen Log Analytics-Arbeitsbereich.

Name	Typ	Beschreibung
id	string	Ein Bezeichner für die Ressource in Power BI.
resourceGroup	string	Die Ressourcengruppe innerhalb des Abonnements, in dem sich die Ressource befindet.
resourceName	string	Der Name der Ressource.
subscriptionId	string	Das Azure-Abonnement, in dem sich die Ressource befindet.

DashboardUser

Ein Power BI-Benutzerzugriffsrechteintrag für eine Dashboard

Name	Typ	Beschreibung
dashboardUserAccessRight	DashboardUserAccessRight	Das Zugriffsrecht, das der Benutzer für die Dashboard 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 Mehrinstanzenlösung.
userType	string	Typ des Benutzers.

DashboardUserAccessRight

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

Name	Typ	Beschreibung
None	string	Keine Berechtigung für Inhalte in Dashboard
Owner	string	Gewährt Lese-, Schreib- und erneuten Zugriff auf Inhalte im Bericht
Read	string	Gewährt Lesezugriff auf Inhalte in Dashboard
ReadCopy	string	Gewährt Lese- und Kopierzugriff auf Inhalte in Dashboard
ReadReshare	string	Gewährt lese- und erneuten Zugriff auf Inhalte in Dashboard
ReadWrite	string	Gewährt Lese- und Schreibzugriff auf Inhalte in Dashboard

DataflowUser

Ein Power BI-Benutzerzugriffsrechteintrag für einen Dataflow

Name	Typ	Beschreibung
DataflowUserAccessRight	DataflowUserAccessRight	Das Zugriffsrecht, das ein Benutzer für den Dataflow 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 Mehrinstanzenlösung.
userType	string	Typ des Benutzers.

DataflowUserAccessRight

Das Zugriffsrecht, das ein Benutzer für den Dataflow hat (Berechtigungsstufe)

Name	Typ	Beschreibung
None	string	Entfernt die Berechtigung für Inhalte im Dataflow.
Owner	string	Gewährt Lese-, Schreib- und erneuten Zugriff auf Inhalte im Dataflow
Read	string	Gewährt Lesezugriff auf Inhalte im Dataflow
ReadReshare	string	Gewährt Lese- und Erneuten Freigabezugriff auf Inhalte im Dataflow
ReadWrite	string	Gewährt Lese- und Schreibzugriff auf Inhalte im Dataflow

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	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 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.

DefaultDatasetStorageFormat

Das Standardspeicherformat für Datasets in der Gruppe

Name	Typ	Beschreibung
Large	string	Speicherformat für großes Datasets
Small	string	Speicherformat für kleine Datasets

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	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.

GroupType

Der Gruppentyp

Name	Typ	Beschreibung
Group	string	V1-Version des freigegebenen Arbeitsbereichs. Diese Art von Arbeitsbereichen wird veraltet sein, da Microsoft alle Arbeitsbereiche zur neuesten Version des freigegebenen Arbeitsbereichs migriert.
Personal	string	Spezieller Arbeitsbereichstyp für SharePoint-Liste und OneDrive-Integration
PersonalGroup	string	"Mein Arbeitsbereich", auch bekannt als persönlicher Arbeitsbereich
Workspace	string	Freigegebener Arbeitsbereich oder einfacher Arbeitsbereich, der zum Freigeben von Inhalten für andere Benutzer im organization

GroupUser

Ein Power BI-Benutzer mit Zugriff auf den Arbeitsbereich

Name	Typ	Beschreibung
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.
groupUserAccessRight	GroupUserAccessRight	Das Zugriffsrecht (Berechtigungsstufe), über das ein Benutzer im Arbeitsbereich verfügt
identifier	string	Bezeichner des Prinzipals
principalType	PrincipalType	Der Prinzipaltyp
profile	ServicePrincipalProfile	Ein Power BI-Dienst Prinzipalprofil. Nur relevant für Power BI Embedded Mehrinstanzenlösung.
userType	string	Typ des Benutzers.

GroupUserAccessRight

Das Zugriffsrecht (Berechtigungsstufe), das ein Benutzer im Arbeitsbereich hat

Name	Typ	Beschreibung
Admin	string	Administratorrechte für Arbeitsbereichsinhalte
Contributor	string	Lesen und Erkunden des Zugriffs (ReadExplore) auf Arbeitsbereichsinhalte
Member	string	Lese-, Weiterfreigabe- und Sondierungsrechte (ReadReshareExplore) für Arbeitsbereichsinhalte
None	string	Kein Zugriff auf Arbeitsbereichsinhalte
Viewer	string	Schreibgeschützter Zugriff (Lesezugriff) auf Arbeitsbereichsinhalte

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

ReportUser

Ein Power BI-Benutzerzugriffsrechteintrag für einen Bericht

Name	Typ	Beschreibung
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.
reportUserAccessRight	ReportUserAccessRight	Das Zugriffsrecht, das der Benutzer für den Bericht hat (Berechtigungsstufe)
userType	string	Typ des Benutzers.

ReportUserAccessRight

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

Name	Typ	Beschreibung
None	string	Keine Berechtigung für Inhalte im Bericht
Owner	string	Gewährt Lese-, Schreib- und erneuten Zugriff auf Inhalte im Bericht
Read	string	Gewährt Lesezugriff auf Inhalte im Bericht
ReadCopy	string	Gewährt Lese- und Kopierzugriff auf Inhalte im Bericht
ReadReshare	string	Gewährt lese- und erneuten Zugriff auf Inhalte im Bericht
ReadWrite	string	Gewährt Lese- und Schreibzugriff auf Inhalte im Bericht

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

Subscription

Ein E-Mail-Abonnement für ein Power BI-Element (z. B. einen Bericht oder eine Dashboard)

Name	Typ	Beschreibung
artifactDisplayName	string	Der Name des abonnierten Power BI-Elements (z. B. ein Bericht oder ein Dashboard)
artifactId	string	Die ID des abonnierten Power BI-Elements (z. B. ein Bericht oder ein Dashboard)
artifactType	string	Der Typ des Power BI-Elements (z. B. , `ReportDashboard`oder `Dataset`)
attachmentFormat	string	Format des Berichts, der im E-Mail-Abonnement angefügt ist
endDate	string	Enddatum und -uhrzeit des E-Mail-Abonnements
frequency	string	Häufigkeit des E-Mail-Abonnements
id	string	Die Abonnement-ID
isEnabled	boolean	Ob das E-Mail-Abonnement aktiviert ist
linkToContent	boolean	Ob ein Abonnementlink im E-Mail-Abonnement vorhanden ist
previewImage	boolean	Ob ein Screenshot des Berichts im E-Mail-Abonnement vorhanden ist
startDate	string	Startdatum und -uhrzeit des E-Mail-Abonnements
subArtifactDisplayName	string	Der Seitenname des abonnierten Power BI-Elements, wenn es sich um einen Bericht handelt.
title	string	Der App-Name
users	SubscriptionUser[]	Die Details der einzelnen E-Mail-Abonnenten. Wenn Sie den API-Aufruf "Benutzerabonnements abrufen als Admin" verwenden, ist der zurückgegebene Wert ein leeres Array (NULL). Diese Eigenschaft wird in einer bevorstehenden Version aus der Nutzlastantwort entfernt. Sie können Abonnementinformationen für einen Power BI-Bericht oder Dashboard abrufen, indem Sie die API-Aufrufe Berichtsabonnements abrufen als Admin oder Dashboardabonnements abrufen als Admin verwenden.

SubscriptionUser

Ein Power BI-E-Mail-Abonnementbenutzer

Name	Typ	Beschreibung
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 Mehrinstanzenlösung.
userType	string	Typ des Benutzers.

Workbook

Eine Power BI-Arbeitsmappe

Name	Typ	Beschreibung
datasetId	string	Die ID des Datasets, das einer Arbeitsmappe zugeordnet ist. Gilt nur, wenn die Arbeitsmappe über ein zugeordnetes Dataset verfügt.
name	string	Der Arbeitsmappenname

Freigeben über

Admin - Groups UpdateGroupAsAdmin

Berechtigungen

Erforderlicher Bereich

Einschränkungen

URI-Parameter

Anforderungstext

Antworten

Beispiele

Example of assigning Log Analytics workspace

Sample Request

Sample Response

Example of unassigning Log Analytics workspace

Sample Request

Sample Response

Example of updating group description and defaultDatasetStorageFormat

Sample Request

Sample Response

Definitionen

AdminDashboard

AdminDataflow

AdminDataset

AdminGroup

AdminReport

AdminTile

AzureResource

DashboardUser

DashboardUserAccessRight

DataflowUser

DataflowUserAccessRight

DatasetQueryScaleOutSettings

DatasetUser

DatasetUserAccessRight

DefaultDatasetStorageFormat

DependentDataflow

Encryption

EncryptionStatus

GroupType

GroupUser

GroupUserAccessRight

PrincipalType

ReportUser

ReportUserAccessRight

ServicePrincipalProfile

Subscription

SubscriptionUser

Workbook

Zusätzliche Ressourcen