Freigeben über

Groups - Create Group

Dienst:
Power BI REST APIs
API-Version:
v1.0

Erstellt einen neuen Arbeitsbereich.

Erlaubnisse

Erforderlicher Bereich

Workspace.ReadWrite.All 

POST https://api.powerbi.com/v1.0/myorg/groups
Mit optionalen Parametern: 
POST https://api.powerbi.com/v1.0/myorg/groups?workspaceV2={workspaceV2}

URI-Parameter

Name In Erforderlich Typ Beschreibung
workspaceV2
 query

boolean

(Vorschaufeature) Gibt an, ob ein Arbeitsbereich erstellt werden soll. Der einzige unterstützte Wert lautet true.

Anforderungstext

Name Erforderlich Typ Beschreibung
name True

string

Der Name der neu erstellten Gruppe

Antworten

Name Typ Beschreibung
200 OK

Group

OKAY

Beispiele

Create a workspace example
Example

Create a workspace example

Beispielanforderung

POST https://api.powerbi.com/v1.0/myorg/groups?workspaceV2=True
Anforderungstext
{
  "name": "sample workspace"
}

Beispiel für eine Antwort

Statuscode:
200 
{
  "value": [
    {
      "id": "f089354e-8366-4e18-aea3-4cb4a3a50b48",
      "isOnDedicatedCapacity": false,
      "name": "sample workspace"
    }
  ]
}

Example

Beispielanforderung

POST https://api.powerbi.com/v1.0/myorg/groups
Anforderungstext
{
  "name": "sample group"
}

Beispiel für eine Antwort

Statuscode:
200 
{
  "value": [
    {
      "id": "f089354e-8366-4e18-aea3-4cb4a3a50b48",
      "isReadOnly": false,
      "isOnDedicatedCapacity": false,
      "name": "sample group"
    }
  ]
}

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
GroupCreationRequest

Eine Power BI-Anforderung zum Erstellen einer neuen 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

Objekt

Eine Power BI-Gruppe

Name Typ Beschreibung
capacityId

string (uuid)

Die Kapazitäts-ID
dataflowStorageId

string (uuid)

Die Power BI-Speicherkonto-ID
defaultDatasetStorageFormat

DefaultDatasetStorageFormat

Das Standardspeicherformat des Datasets im Arbeitsbereich. Wird nur zurückgegeben, wenn isOnDedicatedCapacitytrue
id

string (uuid)

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 beim Abrufen einer einzelnen Gruppe zurückgegeben.
name

string

Der Gruppenname

GroupCreationRequest

Objekt

Eine Power BI-Anforderung zum Erstellen einer neuen Gruppe

Name Typ Beschreibung
name

string

Der Name der neu erstellten Gruppe