Groups - Get Group

Dienst:: Power BI REST APIs

API-Version:: v1.0

Gibt einen angegebenen Arbeitsbereich zurück.

Erlaubnisse

Dieser API-Aufruf kann von einem Dienstprinzipalprofil aufgerufen werden. Weitere Informationen finden Sie unter: Dienstprinzipalprofile in Power BI Embedded.

Erforderlicher Bereich

Workspace.Read.All oder Workspace.ReadWrite.All

Einschränkungen

Benutzerberechtigungen für Arbeitsbereiche nehmen Zeit in Anspruch, um aktualisiert zu werden und sind möglicherweise nicht sofort verfügbar, wenn API-Aufrufe verwendet werden. Verwenden Sie zum Aktualisieren von Benutzerberechtigungen den Aktualisieren von Benutzerberechtigungen API-Aufrufs.

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

URI-Parameter

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

Antworten

Name	Typ	Beschreibung
200 OK	Group	OKAY

Beispiele

Example

Beispielanforderung

GET https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48

Beispiel für eine Antwort

Statuscode:: 200

{
  "id": "f089354e-8366-4e18-aea3-4cb4a3a50b48",
  "isReadOnly": false,
  "isOnDedicatedCapacity": true,
  "capacityId": "0f084df7-c13d-451b-af5f-ed0c466403b2",
  "defaultDatasetStorageFormat": "Small",
  "name": "Sample Group 1"
}

Definitionen

Name	Beschreibung
AzureResource	Eine Antwort, die eine azure-Ressource im Besitz eines Benutzers wie einen Log Analytics-Arbeitsbereich detailiert.
DefaultDatasetStorageFormat	Das Standardmäßige Datasetspeicherformat in der Gruppe
Group	Eine Power BI-Gruppe

AzureResource

Objekt

Eine Antwort, die eine azure-Ressource im Besitz eines Benutzers wie einen Log Analytics-Arbeitsbereich detailiert.

Name	Typ	Beschreibung
id	string (uuid)	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 (uuid)	Das Azure-Abonnement, in dem sich die Ressource befindet.

DefaultDatasetStorageFormat

Enumeration

Das Standardmäßige Datasetspeicherformat in der Gruppe

Wert	Beschreibung
Small	Kleines Dataset-Speicherformat
Large	Großes Dataset-Speicherformat

Group