Groups - Create Group

Service:

Power BI REST APIs

API Version:

v1.0

Tworzy nowy obszar roboczy.

Uprawnienia

To wywołanie interfejsu API może być wywoływane przez profil jednostki usługi. Aby uzyskać więcej informacji, zobacz: Profile jednostki usługi w Power BI Embedded.

Wymagany zakres

Workspace.ReadWrite.All

POST https://api.powerbi.com/v1.0/myorg/groups

With optional parameters:

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
workspaceV2	query		boolean	(Funkcja w wersji zapoznawczej) Czy utworzyć obszar roboczy. Jedyną obsługiwaną wartością jest true.

Treść żądania

Nazwa	Wymagane	Typ	Opis
name	True	string	Nazwa nowo utworzonej grupy

Odpowiedzi

Nazwa	Typ	Opis
200 OK	Group	OK

Przykłady

Create a workspace example

Example

Create a workspace example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups?workspaceV2=True

Request Body

{
  "name": "sample workspace"
}

Sample Response

Status code:

200

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

Example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups

Request Body

{
  "name": "sample group"
}

Sample Response

Status code:

200

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

Definicje

Nazwa	Opis
AzureResource	Odpowiedź opisująca zasób platformy Azure należący do użytkownika, taki jak obszar roboczy usługi Log Analytics.
DefaultDatasetStorageFormat	Domyślny format magazynu zestawu danych w grupie
Group	Grupa usługi Power BI
GroupCreationRequest	Żądanie usługi Power BI dotyczące utworzenia nowej grupy

AzureResource

Odpowiedź opisująca zasób platformy Azure należący do użytkownika, taki jak obszar roboczy usługi Log Analytics.

Nazwa	Typ	Opis
id	string	Identyfikator zasobu w usłudze Power BI.
resourceGroup	string	Grupa zasobów w ramach subskrypcji, w której znajduje się zasób.
resourceName	string	Nazwa zasobu.
subscriptionId	string	Subskrypcja platformy Azure, w której znajduje się zasób.

DefaultDatasetStorageFormat

Domyślny format magazynu zestawu danych w grupie

Nazwa	Typ	Opis
Large	string	Format dużego magazynu zestawu danych
Small	string	Format magazynu małych zestawów danych

Group

Grupa usługi Power BI

Nazwa	Typ	Opis
capacityId	string	Identyfikator pojemności
dataflowStorageId	string	Identyfikator konta magazynu przepływu danych usługi Power BI
defaultDatasetStorageFormat	DefaultDatasetStorageFormat	Domyślny format magazynu zestawu danych w obszarze roboczym. Zwracane tylko wtedy, gdy isOnDedicatedCapacity jest true
id	string	Identyfikator obszaru roboczego
isOnDedicatedCapacity	boolean	Czy grupa jest przypisana do pojemności dedykowanej
isReadOnly	boolean	Czy grupa jest tylko do odczytu
logAnalyticsWorkspace	AzureResource	Obszar roboczy usługi Log Analytics przypisany do grupy. Jest to zwracane tylko w przypadku pobierania pojedynczej grupy.
name	string	Nazwa grupy

GroupCreationRequest

Żądanie usługi Power BI dotyczące utworzenia nowej grupy

Nazwa	Typ	Opis
name	string	Nazwa nowo utworzonej grupy